Поделиться через

Функция InternetAutodial (wininet.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 wininet.h (включая Wininet.h)
Библиотека Wininet.lib
DLL Wininet.dll

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

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

Функции WinINet