Функция IsNetworkAlive (sensapi.h)
Функция IsNetworkAlive определяет, подключена ли локальная система к сети, и определяет тип сетевого подключения, например локальную сеть, глобальную сеть или и то, и другое.
Синтаксис
BOOL IsNetworkAlive(
[out] LPDWORD lpdwFlags
);
Параметры
[out] lpdwFlags
Доступный тип сетевого подключения. Этот параметр может иметь одно из следующих значений:
NETWORK_ALIVE_LAN
На компьютере есть одна или несколько активных сетевых карт.
NETWORK_ALIVE_WAN
Компьютер имеет одно или несколько активных подключений RAS.
Возвращаемое значение
Всегда вызывайте Метод GetLastError перед проверкой кода возврата этой функции. Если последняя ошибка не имеет значения 0, функция IsNetworkAlive завершилась сбоем и следующие значения TRUE и FALSE не применяются.
| Код возврата | Описание |
|---|---|
|
Если последняя ошибка имеет значение 0 и функция возвращает значение TRUE, функция SENS определила, что локальная система подключена к сети.
Сведения о типе подключения см. в параметре lpdwFlags . |
|
Если последняя ошибка имеет значение 0, а функция возвращает значение FALSE, функция SENS определила, что соединение отсутствует. |
Комментарии
Начиная с приложений, предназначенных для Windows Vista и Windows Server 2008, разработчикам следует рассмотреть возможность использования диспетчера списков сетей вместо этой функции.
Эта функция может использоваться приложением для определения наличия сетевого подключения перед продолжением сетевых операций. Тип приложения службы каталогов, почтовый клиент или интернет-браузер могут адаптироваться к различным типам сетевых подключений. Например, операцию печати можно отложить до тех пор, пока не будет доступно сетевое подключение.
Для приложения не всегда может быть целесообразно вызвать IsNetworkAlive , чтобы определить, отключена ли локальная система от локальной сети, так как IsNetworkAlive может работать медленно, а для обнаружения отключения локальной системы функции может потребоваться слишком много времени. Однако IsNetworkAlive всегда может определить подключение к глобальной сети в данный момент.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | sensapi.h |
| Библиотека | Sensapi.lib |
| DLL | Sensapi.dll |