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

Статья
11/20/2024

Функция IsDestinationReachable определяет, можно ли достичь указанного назначения и предоставляет сведения о качестве подключения (QOC) для назначения.

Windows Vista и более поздних версий Windows Server 2008 и более поздних версий: эта функция не поддерживается и всегда возвращает ERROR_CALL_NOT_IMPLEMENTED.

Синтаксис

BOOL IsDestinationReachableA(
  [in]      LPCSTR    lpszDestination,
  [in, out] LPQOCINFO lpQOCInfo
);

Параметры

[in] lpszDestination

Указатель на строку null-terminated, указывающую назначение. Назначение может быть IP-адресом, именем UNC или URL-адресом.

[in, out] lpQOCInfo

Указатель на структуру QOCINFO , которая получает сведения о качестве подключения (QOC). Вы можете указать указатель NULL, если вы не хотите получать сведения о QOC.

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

Возвращаемый код	Описание
TRUE	Можно достичь назначения.
FALSE	Не удается достичь назначения. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
ERROR_CALL_NOT_IMPLEMENTED	Эта функция недоступна в Windows Vista.

Замечания

Клиентские приложения используют эту функцию для определения сведений о QOC перед продолжением сетевых операций. Для автономных компьютеров, которые напрямую подключены к сети через сетевую карту или сервер удаленного доступа (RAS), эта функция создает минимальный сетевой трафик с вызовами RPC к ближайшему маршрутизатору. Для компьютеров, которые являются частью сети, в которой можно достичь назначения с помощью RAS или сетевого шлюза, эта функция отправляет связь с назначением для создания точных сведений о QOC.

Эта функция доступна только для подключений TCP/IP. Вызывающий объект предоставляет буфер для структуры QOCINFO и должен освободить память, если она не требуется.

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

Заметка

Заголовок sensapi.h определяет IsDestinationReachable как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	sensapi.h
библиотеки	Sensapi.lib
DLL	Sensapi.dll

См. также

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

IsNetworkAlive

QOCINFO

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