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

Статья
11/20/2024

Запрашивает у пользователя разрешение на инициирование подключения к URL-адресу.

Синтаксис

BOOL InternetGoOnlineA(
  [in] LPCSTR lpszURL,
  [in] HWND   hwndParent,
  [in] DWORD  dwFlags
);

Параметры

[in] lpszURL

Указатель на строку, завершающуюся значением NULL, которая указывает URL-адрес веб-сайта для подключения.

[in] hwndParent

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

[in] dwFlags

Этот параметр может быть равен нулю или следующему флагу.

Ценность	Значение
INTERNET_GOONLINE_REFRESH	Этот флаг не используется.

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

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

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

Если функции завершатся ошибкой, он может вернуть следующий код ошибки:

Возвращаемый код	Описание
ERROR_INVALID_PARAMETER	Один или несколько параметров неверны. Параметр dwFlags содержит значение, отличное от нуля или INTERNET_GOONLINE_REFRESH.

Замечания

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

Заметка

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

Требования

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

См. также

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

функций WinINet

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