Функция InternetDialA (wininet.h)

Статья
11/20/2024

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

Синтаксис

DWORD InternetDialA(
  [in]  HWND      hwndParent,
  [in]  LPSTR     lpszConnectoid,
  [in]  DWORD     dwFlags,
  [out] DWORD_PTR *lpdwConnection,
  [in]  DWORD     dwReserved
);

Параметры

[in] hwndParent

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

[in] lpszConnectoid

Указатель на строку null-terminated, указывающую имя используемого подключения к телефону. Если этот параметр содержит пустую строку (""), пользователь выбирает подключение. Если этот параметр 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 не поддерживает подключения с двойным подключением, проверку подлинности SmartCard или подключения, требующие сертификации на основе реестра.

Примечание начиная с Windows Vista и Windows Server 2008, функции подключения WinINet используют функции RAS для установления подключения к телефонной связи. WinINet поддерживает функции, описанные в функции RasDialDlg.

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

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

Заметка

Заголовок wininet.h определяет InternetDial как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wininet.h (включая Wininet.h, Winineti.h, Wininet.h, Winineti.h)
библиотеки	Wininet.lib
DLL	Wininet.dll

См. также

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

Функции WinINet

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