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

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

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

Синтаксис

BOOL InternetGetConnectedStateEx(
  [out] LPDWORD lpdwFlags,
  [out] LPSTR   lpszConnectionName,
  [in]  DWORD   dwNameLen,
  [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

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

[in] dwNameLen

Размер строки lpszConnectionName в TCHAR.

[in] dwReserved

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

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

Возвращает значение 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, Winineti.h, Wininet.h, Winineti.h)
Библиотека Wininet.lib
DLL Wininet.dll

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

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

Функции WinINet