На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

RasGetAutodialAddress



[New - Windows NT]

The RasGetAutodialAddress function retrieves information about all the AutoDial entries associated with a network address in the AutoDial mapping database.

DWORD RasGetAutodialAddress(

LPTSTR lpszAddress, // pointer to a network address string
LPDWORD lpdwReserved, // reserved; must be NULL
LPRASAUTODIALENTRY lpAutoDialEntries, // pointer to buffer for AutoDial entry data
LPDWORD lpdwcbAutoDialEntries, // pointer to size, in bytes, of buffer
LPDWORD lpdwcAutoDialEntries // pointer to number of entries returned
);


Parameters

lpszAddress

Pointer to a null-terminated string that specifies the address for which information is requested. This can be an IP address ("127.95.1.4"), Internet host name ("www.microsoft.com"), or NetBIOS name ("products1").

lpdwReserved

Reserved; must be NULL.

lpAutoDialEntries

Pointer to a buffer that receives an array of RASAUTODIALENTRY structures, one for each AutoDial entry associated with the address specified by the lpszAddress parameter. Before calling RasGetAutodialAddress, set the dwSize member of the first RASAUTODIALENTRY structure in the buffer to sizeof(RASAUTODIALENTRY) to identify the version of the structure.
If lpAutoDialEntries is NULL, RasGetAutodialAddress sets the lpdwcbAutoDialEntries and lpdwcAutoDialEntries parameters to indicate the required buffer size, in bytes, and the number of AutoDial entries.

lpdwcbAutoDialEntries

Pointer to a variable that contains the size, in bytes, of the lpAutoDialEntries buffer. On return, the function sets this variable to the number of bytes returned, or the number of bytes required if the buffer is too small.

lpdwcAutoDialEntries

Pointer to a variable that receives the number of structure elements returned in the lpAutoDialEntries buffer.



Return Values

If the function succeeds, the return value is zero.
If the function fails, the return value is one of the following error codes.

Value Meaning
ERROR_XXX_NOT_FOUND The address was not found in the mapping database.
ERROR_INVALID_SIZE The dwSize member of the RASAUTODIALENTRY structure is an invalid value.
ERROR_INVALID_PARAMETER The lpszAddress, lpdwcbAutoDialEntries, or lpdwcAutoDialEntries parameter was NULL.


See Also

RASAUTODIALENTRY, RasEnumAutodialAddresses, RasSetAutodialAddress


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

RasGetAutodialAddress



[Новый - Windows NT]

Функция RasGetAutodialAddress извлекает информацию о всех данных AutoDial связанных сетевым адресом в AutoDial, отображающий базу данных.

DWORD RasGetAutodialAddress(

LPTSTR lpszAddress, // УКАЗАТЕЛЬ в сетевую строку адреса LPDWORD lpdwReserved, // зарезервированное; должно быть NULL LPRASAUTODIALENTRY lpAutoDialEntries, // указателем, чтобы буферизоваться для данных входа AutoDial LPDWORD lpdwcbAutoDialEntries, // указатель в размер, в байтах, указателя буфера LPDWORD lpdwcAutoDialEntries // в номер данных возвращался
);


Параметры

lpszAddress

Указатель в недействительный расторгнутую строку, которая определяет адрес для которого информация требуется. Это может быть адресом IP ("127.95.1.4"), главное имя Internet ("www.microsoft.com"), или имя NetBIOS ("products1").

lpdwReserved

Зарезервированное; должно быть НЕДЕЙСТВИТЕЛЬНО.

lpAutoDialEntries

Указатель в буфер, который получает массив структур RASAUTODIALENTRY, за каждого входа AutoDial связанного адресом определенного параметром lpszAddress. Перед вызовом RasGetAutodialAddress, установите элемент dwSize первой структуры RASAUTODIALENTRY в буфере, чтобы sizeof(RASAUTODIALENTRY), чтобы идентифицировать версию структуры.
Если lpAutoDialEntries НЕДЕЙСТВИТЕЛЕН, RasGetAutodialAddress устанавливает lpdwcbAutoDialEntries и параметры lpdwcAutoDialEntries, чтобы указывать необходимый буферный размер, в байтах, и числе данных AutoDial.

lpdwcbAutoDialEntries

Указатель в переменную, которая содержит размер, в байтах, буфера lpAutoDialEntries. В возврате, функция устанавливает эту переменную в количество байтов возвращанных, или количество байтов требовалось если буфер слишком небольшой.

lpdwcAutoDialEntries

Указатель в переменную, которая получает количество структурных элементов возвращался в буфер lpAutoDialEntries.



Обратные Величины

Если функция добивается успеха, обратная величина нулевая.
Если функция терпит неудачу, обратная величина - один из следующих кодов ошибки.

Значение Величины
ERROR_XXX_NOT_FOUND адрес не был обнаружен в отображающей базе данных.
ERROR_INVALID_SIZE элемент dwSize структуры RASAUTODIALENTRY является неправильной величиной.
ERROR_INVALID_PARAMETER lpszAddress, lpdwcbAutoDialEntries, или параметр lpdwcAutoDialEntries был НЕДЕЙСТВИТЕЛЕН.


Смотри Также

RASAUTODIALENTRY, RasEnumAutodialAddresses, RasSetAutodialAddress


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz