通过

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

指向接收连接质量（QOC）信息的 QOCINFO 结构的指针。 如果不想接收 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 [仅限桌面应用]
目标平台 窗户
标头 sensapi.h
库 Sensapi.lib
DLL Sensapi.dll

另请参阅

关于系统事件通知服务 的

IsNetworkAlive

QOCINFO