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

Статья
11/20/2024

Примечание Использование этого API не рекомендуется, используйте вместо этого метод INetworkListManager::GetConnectivity.

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

Синтаксис

BOOL InternetGetConnectedStateExW(
  [out] LPDWORD lpdwFlags,
  [out] LPWSTR  lpszConnectionName,
        DWORD   cchNameLen,
  [in]  DWORD   dwReserved
);

Параметры

[out] lpdwFlags

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

Ценность	Значение
INTERNET_CONNECTION_CONFIGURED 0x40	Локальная система имеет допустимое подключение к Интернету, но может или не подключена в данный момент.
INTERNET_CONNECTION_LAN 0x02	Локальная система использует локальную сеть для подключения к Интернету.
INTERNET_CONNECTION_MODEM 0x01	Локальная система использует модем для подключения к Интернету.
INTERNET_CONNECTION_MODEM_BUSY 0x08	Больше не используется.
INTERNET_CONNECTION_OFFLINE 0x20	Локальная система находится в автономном режиме.
INTERNET_CONNECTION_PROXY 0x04	Локальная система использует прокси-сервер для подключения к Интернету.

[out] lpszConnectionName

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

cchNameLen

ТБD

[in] dwReserved

Этот параметр зарезервирован и должен быть null.

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

Возвращает значение TRUE, если есть подключение к Интернету или FALSE, если нет подключения к Интернету или если все возможные подключения к Интернету в настоящее время не активны. Дополнительные сведения см. в разделе "Примечания".

Если InternetGetConnectedState возвращает false, приложение может вызывать GetLastError, чтобы получить код ошибки.

Замечания

Возвращаемое значение TRUE из InternetGetConnectedState указывает, что доступно хотя бы одно подключение к Интернету. Это не гарантирует, что подключение к конкретному узлу можно установить. Приложения всегда должны проверять наличие ошибок, возвращаемых из вызовов API, которые подключаются к серверу. InternetCheckConnection можно вызвать, чтобы определить, можно ли установить подключение к конкретному назначению.

Возвращаемое значение TRUE указывает, что подключение к модему активно или подключение локальной сети активно, а прокси-сервер правильно настроен для локальной сети. Возвращаемое значение FALSE указывает, что ни модем, ни локальная сеть не подключены. Если возвращается false, флаг INTERNET_CONNECTION_CONFIGURED может быть установлен, чтобы указать, что автодиал настроен на "всегда набирать", но в данный момент не активен. Если автодиал не настроен, функция возвращает FALSE.

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

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

Заметка

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

Требования

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

См. также

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

функций WinINet

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