Функция InternetAutodial (winineti.h)

  • Статья

Вызывает автоматическое подключение модема к Интернету по умолчанию.

Синтаксис

BOOL InternetAutodial(
  [in] DWORD dwFlags,
  [in] HWND  hwndParent
);

Параметры

[in] dwFlags

Управляет этой операцией. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
INTERNET_AUTODIAL_FAILIFSECURITYCHECK
0x04
 Вызывает сбой InternetAutodial , если общий доступ к файлам и принтерам отключен для Windows 95 или более поздней версии.

Windows Server 2008 и Windows Vista: Этот флаг устарел.
INTERNET_AUTODIAL_FORCE_ONLINE
0x01
 Принудительное подключение к Интернету.
INTERNET_AUTODIAL_FORCE_UNATTENDED
0x02
 Принудительное автоматическое подключение к Интернету.
INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT
0x08
 Заставляет InternetAutodial набирать модемное подключение, даже если имеется сетевое подключение к Интернету.

[in] hwndParent

Дескриптор родительского окна.

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

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

Если функция завершается сбоем, она возвращает значение FALSE. Приложения могут вызывать GetLastError для получения кода ошибки.

Комментарии

InternetAutodial не поддерживает подключения с двойным набором, проверку подлинности SmartCard или подключения, требующие сертификации на основе реестра.

Примечание Начиная с Windows Vista и Windows Server 2008 функции удаленного доступа WinINet используют функции RAS для установки коммутируемого подключения. WinINet поддерживает функции, описанные в функции RasDialDlg .
 
InternetAutodial не пытается набрать номер, если в системе имеется коммутируемое подключение. Кроме того, если имеется подключение по локальной сети и InternetAutodial не настроен для принудительного набора номера (задайте INTERNET_AUTODIAL_FORCE_ONLINE в параметре dwFlags ), InternetAutodial не пытается подключиться и возвращает значение TRUE.

Как и все другие аспекты API WinINet, эту функцию нельзя безопасно вызывать из библиотеки DllMain или из конструкторов и деструкторов глобальных объектов.

Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для серверных реализаций или служб используйте службы Microsoft Windows HTTP (WinHTTP).
 

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winineti.h (включая Wininet.h)
Библиотека Wininet.lib
DLL Wininet.dll

См. также раздел

Установка коммутируемого подключения к Интернету

Функции WinINet