Функция RasGetAutodialAddressA (ras.h)
Функция RasGetAutodialAddress извлекает сведения обо всех записях autoDial, связанных с сетевым адресом в базе данных сопоставления autoDial.
Синтаксис
DWORD RasGetAutodialAddressA(
[in] LPCSTR unnamedParam1,
[in] LPDWORD unnamedParam2,
[in, out] LPRASAUTODIALENTRYA unnamedParam3,
[in, out] LPDWORD unnamedParam4,
[out] LPDWORD unnamedParam5
);
Параметры
[in] unnamedParam1
Указатель на строку, завершающуюся значением NULL, которая указывает адрес, для которого запрашиваются сведения. Это может быть IP-адрес, имя узла Интернета ("www.microsoft.com") или NetBIOS-имя ("products1").
Если этот параметр имеет значение NULL, функция получает подключение к Интернету по умолчанию. Функция возвращает подключение к Интернету по умолчанию для каждого пользователя, если оно настроено. В противном случае функция возвращает глобальное подключение к Интернету по умолчанию. Если подключения к Интернету по умолчанию не настроены, функция возвращает ноль для параметров lpdwcbAutoDialEntries и lpdwcAutoDialEntries .
[in] unnamedParam2
Защищены; значение должно иметь значение NULL.
[in, out] unnamedParam3
Указатель на буфер, который в выходных данных получает массив структур RASAUTODIALENTRY , по одному для каждой записи autoDial, связанной с адресом, указанным параметром lpszAddress .
На входных данных задайте члену dwSize первой структуры RASAUTODIALENTRY в буфере значение sizeof(RASAUTODIALENTRY), чтобы определить версию структуры.
Если lpAutoDialEntries имеет значение NULL, RasGetAutodialAddress задает параметры lpdwcbAutoDialEntries и lpdwcAutoDialEntries , чтобы указать требуемый размер буфера в байтах и количество записей AutoDial.
[in, out] unnamedParam4
Указатель на переменную, которая на входных данных указывает размер буфера lpAutoDialEntries в байтах .
В выходных данных эта переменная получает количество возвращаемых байтов или количество байтов, необходимое, если буфер слишком мал.
[out] unnamedParam5
Указатель на переменную, которая получает количество элементов структуры, возвращаемых в буфере lpAutoDialEntries .
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается ошибкой, возвращается один из следующих кодов ошибок или значение из кода ошибок маршрутизации и удаленного доступа или Winerror.h.
Значение | Значение |
---|---|
|
Член dwSize структуры RASAUTODIALENTRY является недопустимым значением. |
|
Параметр lpszAddress, lpdwcbAutoDialEntries или lpdwcAutoDialEntries имеет значение NULL. |
Комментарии
Служба удаленного доступа (RAS) поддерживает подключения к Интернету по умолчанию. RAS поддерживает подключение к Интернету по умолчанию, которое является глобальным для локального компьютера, и, кроме того, поддерживает подключение к Интернету по умолчанию для каждого пользователя.
Имя глобального подключения к Интернету по умолчанию хранится в реестре под следующим разделом реестра:
HKEY_LOCAL_MACHINE Software Microsoft Ras Autodial Default
Значение, в котором хранится имя подключения:
DefaultInternet
Это значение имеет тип REG_SZ.
Глобальное подключение к Интернету по умолчанию должно быть настроено как подключение для всех пользователей в пользовательском интерфейсе папки Connections.
Имя подключения к Интернету по умолчанию для каждого пользователя хранится в реестре под следующим разделом реестра:
HKEY_CURRENT_USER\Программного обеспечения\Microsoft\Ras Autodial\По умолчанию
Значение, в котором хранится имя подключения:
DefaultInternet
Это значение имеет тип REG_SZ.
Примечание
Заголовок ras.h определяет RasGetAutodialAddress в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | ras.h |
Библиотека | Rasapi32.lib |
DLL | Rasapi32.dll |