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

[InternetCheckConnection доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте NetworkInformation.GetInternetConnectionProfile или интерфейсы NLM. ]

Позволяет приложению проверка, можно ли установить подключение к Интернету.

Синтаксис

BOOL InternetCheckConnectionA(
  [in] LPCSTR lpszUrl,
  [in] DWORD  dwFlags,
  [in] DWORD  dwReserved
);

Параметры

[in] lpszUrl

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

[in] dwFlags

Параметры. FLAG_ICC_FORCE_CONNECTION — единственный доступный в настоящее время флаг. Если этот флаг установлен, он принудительно устанавливает соединение. Попытка подключения к сокетам выполняется в следующем порядке:

• Если значение lpszUrl не равно NULL, значение узла извлекается из него и используется для проверки проверки связь с конкретным узлом.
• Если lpszUrl имеет значение NULL и во внутренней серверной базе данных есть запись для ближайшего сервера, значение узла извлекается из записи и используется для проверки проверки связь с этим сервером.

[in] dwReserved

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

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

Возвращает значение TRUE , если соединение установлено успешно, или false в противном случае. Используйте GetLastError , чтобы получить код ошибки. ERROR_NOT_CONNECTED возвращается методом GetLastError , если подключение невозможно или база данных сокетов находится в автономном режиме безоговорочно.

Комментарии

InternetCheckConnection является нерекомендуемой. InternetCheckConnection не работает в средах, использующих веб-прокси-сервер для доступа к Интернету. В зависимости от среды используйте NetworkInformation.GetInternetConnectionProfile или интерфейсы NLM, чтобы проверка для доступа к Интернету.

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

 

Примечание

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

Требования

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

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

Включение функциональных возможностей Интернета

Функции WinINet