Функция IsNetworkAlive (sensapi.h)

Функция IsNetworkAlive определяет, подключена ли локальная система к сети, и определяет тип сетевого подключения, например локальную сеть, глобальную сеть или и то, и другое.

Синтаксис

BOOL IsNetworkAlive(
  [out] LPDWORD lpdwFlags
);

Параметры

[out] lpdwFlags

Доступный тип сетевого подключения. Этот параметр может иметь одно из следующих значений:

NETWORK_ALIVE_LAN

На компьютере есть одна или несколько активных сетевых карт.

NETWORK_ALIVE_WAN

Компьютер имеет одно или несколько активных подключений RAS.

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

Всегда вызывайте Метод GetLastError перед проверкой кода возврата этой функции. Если последняя ошибка не имеет значения 0, функция IsNetworkAlive завершилась сбоем и следующие значения TRUE и FALSE не применяются.

Код возврата	Описание
TRUE	Если последняя ошибка имеет значение 0 и функция возвращает значение TRUE, функция SENS определила, что локальная система подключена к сети. Сведения о типе подключения см. в параметре lpdwFlags .
FALSE	Если последняя ошибка имеет значение 0, а функция возвращает значение FALSE, функция SENS определила, что соединение отсутствует.

Комментарии

Начиная с приложений, предназначенных для Windows Vista и Windows Server 2008, разработчикам следует рассмотреть возможность использования диспетчера списков сетей вместо этой функции.

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

Для приложения не всегда может быть целесообразно вызвать IsNetworkAlive , чтобы определить, отключена ли локальная система от локальной сети, так как IsNetworkAlive может работать медленно, а для обнаружения отключения локальной системы функции может потребоваться слишком много времени. Однако IsNetworkAlive всегда может определить подключение к глобальной сети в данный момент.

Примечание Эта функция доступна только для подключений TCP/IP.

 

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	sensapi.h
Библиотека	Sensapi.lib
DLL	Sensapi.dll

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

Сведения о службе уведомлений о системных событиях

IsDestinationReachable