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

Статья
08/27/2023

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

Извлекает состояние подключения локальной системы.

Синтаксис

BOOL InternetGetConnectedState(
  [out] LPDWORD lpdwFlags,
  [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	Локальная система использует прокси-сервер для подключения к Интернету.
INTERNET_RAS_INSTALLED 0x10	В локальной системе установлен ras-файл.

[in] dwReserved

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

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

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

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

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

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

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

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

Требования

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

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

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

Функции WinINet

Share via