IsDestinationReachableA 函数 (sensapi.h)

IsDestinationReachable 函数确定是否可以到达指定的目标，并为目标提供连接质量 (QOC) 信息。

Windows Vista 及更高版本、Windows Server 2008 及更高版本： 此函数不受支持，并且始终返回 ERROR_CALL_NOT_IMPLEMENTED。

语法

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

参数

[in] lpszDestination

指向以 null 结尾的字符串的指针，该字符串指定目标。 目标可以是 IP 地址、UNC 名称或 URL。

[in, out] lpQOCInfo

指向 QOCINFO 结构的指针，该结构接收连接质量 (QOC) 信息。 如果不想接收 QOC 信息，可以提供 NULL 指针。

返回值

返回代码	说明
TRUE	可以访问目标。
FALSE	无法访问目标。 要获得更多的错误信息，请调用 GetLastError。
ERROR_CALL_NOT_IMPLEMENTED	此函数在 Windows Vista 上不可用。

注解

客户端应用程序使用此函数来确定 QOC 信息，然后再继续执行网络操作。 对于通过网络卡或远程访问服务器直接连接到网络的独立计算机， (RAS) ，此函数通过对最近的路由器的 RPC 调用生成最小网络流量。 对于属于网络一部分的计算机，可以使用 RAS 或网络网关访问目标，此函数 ping 目标以生成准确的 QOC 信息。

此函数仅适用于 TCP/IP 连接。 调用方为 QOCINFO 结构提供缓冲区，并且必须在不需要内存时释放内存。

从为 Windows Vista 和 Windows Server 2008 设计的应用程序开始，开发人员应考虑使用 网络列表管理器 而不是此函数。

注意

sensapi.h 标头将 IsDestinationReachable 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	sensapi.h
Library	Sensapi.lib
DLL	Sensapi.dll

另请参阅

关于系统事件通知服务

IsNetworkAlive

QOCINFO