Функция RasGetAutodialAddressA (ras.h)

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

Синтаксис

DWORD RasGetAutodialAddressA(
  [in]      LPCSTR              unnamedParam1,
  [in]      LPDWORD             unnamedParam2,
  [in, out] LPRASAUTODIALENTRYA unnamedParam3,
  [in, out] LPDWORD             unnamedParam4,
  [out]     LPDWORD             unnamedParam5
);

Параметры

[in] unnamedParam1

Указатель на строку null-terminated, указывающую адрес, для которого запрашиваются сведения. Это может быть IP-адрес, имя узла Интернета ("www.microsoft.com"), или имя NetBIOS ("products1").

Если этот параметр null, функция извлекает подключение к Интернету по умолчанию. Функция возвращает подключение к Интернету по умолчанию по умолчанию для каждого пользователя, если оно настроено. В противном случае функция возвращает глобальное подключение к Интернету по умолчанию. Если подключение к Интернету по умолчанию не настроено, функция возвращает ноль для параметров lpdwcbAutoDialEntries и lpdwcAutoDialEntries.

[in] unnamedParam2

Скрытный; должен быть null.

[in, out] unnamedParam3

Указатель на буфер, который получает массив структур RASAUTODIALENTRY, по одному для каждой записи AutoDial, связанной с адресом, указанным параметром lpszAddress.

Для входных данных задайте dwSize член первой RASAUTODIALENTRY в буфере значение sizeof(RASAUTODIALENTRY), чтобы определить версию структуры.

Если lpAutoDialEntriesNULL, RasGetAutodialAddress задает lpdwcbAutoDialEntries и lpdwcAutoDialEntries, чтобы указать требуемый размер буфера, в байтах и количество записей автодиалов.

[in, out] unnamedParam4

Указатель на переменную, указывающую размер в байтах буфера lpAutoDialEntries.

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

[out] unnamedParam5

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

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение ERROR_SUCCESS.

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

Замечания

Служба удаленного доступа (RAS) поддерживает подключения к Интернету по умолчанию. RAS поддерживает подключение к Интернету по умолчанию, глобальное к локальному компьютеру, а также поддерживает подключение к Интернету по умолчанию для каждого пользователя.

Имя глобального подключения к Интернету по умолчанию хранится в реестре ниже следующего раздела реестра:

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Ras Autodial
            Default

Значение, которое сохраняет имя подключения:

DefaultInternet

Это значение имеет тип REG_SZ.

Глобальное подключение к Интернету по умолчанию должно быть настроено как Для всех пользователей, подключения в папке подключений пользовательском интерфейсе.

Имя подключения к Интернету по умолчанию для каждого пользователя хранится в реестре ниже следующего раздела реестра:

HKEY_CURRENT_USER\Software\Microsoft\Ras Autodial\по умолчани ю

Значение, которое сохраняет имя подключения:

DefaultInternet

Это значение имеет тип REG_SZ.

Требования

См. также

RASAUTODIALENTRY

RasEnumAutodialAddresses

RasSetAutodialAddress

Обзор службы удаленного доступа (RAS)

функции службы удаленного доступа