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

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

  • Статья
Примечание Использовать этот 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 может быть установлен, чтобы указать, что автодиал настроен на "всегда набирать", но в настоящее время не активен. Если автоматическое определение не настроено, функция возвращает значение FALSE.

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

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

Требования

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

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

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

Функции WinINet