Функция 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.h определяет InternetCheckConnection в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wininet.h |
| Библиотека | Wininet.lib |
| DLL | Wininet.dll |