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

  • Статья

Инициирует подключение к Интернету с помощью модема.

Синтаксис

DWORD InternetDial(
  [in]  HWND    hwndParent,
  [in]  LPSTR   lpszConnectoid,
  [in]  DWORD   dwFlags,
  [out] LPDWORD lpdwConnection,
  [in]  DWORD   dwReserved
);

Параметры

[in] hwndParent

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

[in] lpszConnectoid

Указатель на строку, завершающуюся значением NULL, которая указывает имя используемого коммутируемого подключения. Если этот параметр содержит пустую строку (""), пользователь выбирает подключение. Если этот параметр имеет значение NULL, функция подключается к автоматическому подключению.

[in] dwFlags

Параметры. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
INTERNET_AUTODIAL_FORCE_ONLINE
 Принудительное подключение к сети.
INTERNET_AUTODIAL_FORCE_UNATTENDED
 Принудительное автоматическое подключение к Интернету. Если требуется вмешательство пользователя, функция завершится ошибкой.
INTERNET_DIAL_FORCE_PROMPT
 Игнорирует параметр "набирать автоматически" и принудительно отображает пользовательский интерфейс набора.
INTERNET_DIAL_UNATTENDED
 Подключается к Интернету через модем без отображения пользовательского интерфейса, если это возможно. В противном случае функция будет ожидать ввода данных пользователем.
INTERNET_DIAL_SHOW_OFFLINE
 Отображает кнопку Работать в автономном режиме вместо кнопки Отмена в пользовательском интерфейсе набора.

[out] lpdwConnection

Указатель на переменную, указывающую номер подключения. Это число является уникальным идентификатором подключения, который можно использовать в других функциях, таких как InternetHangUp.

[in] dwReserved

Этот параметр зарезервирован и должен иметь значение NULL.

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

Возвращает ERROR_SUCCESS в случае успешного выполнения или значение ошибки в противном случае. Код ошибки может быть одним из следующих значений.

Код возврата Описание
ERROR_INVALID_PARAMETER
 Один или несколько параметров неверны.
ERROR_NO_CONNECTION
 Возникла проблема с коммутируемым подключением.
ERROR_USER_DISCONNECTION
 Пользователь нажал кнопку Работать в автономном режиме или Отмена в диалоговом окне Подключение к Интернету.

Комментарии

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

Примечание Начиная с Windows Vista и Windows Server 2008 функции удаленного доступа WinINet используют функции RAS для установки коммутируемого подключения. WinINet поддерживает функции, описанные в функции RasDialDlg .
 
Как и все другие аспекты API WinINet, эту функцию нельзя безопасно вызывать из DllMain или конструкторов и деструкторов глобальных объектов.
Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для серверных реализаций или служб используйте службы Microsoft Windows HTTP (WinHTTP).
 

Требования

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

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

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

Функции WinINet