IConnector：：GetConnectorIdConnectedTo 方法 (devicetopology.h)

  • 项目

GetConnectorIdConnectedTo 方法获取此连接器连接到的连接器的全局 ID（如果有）。

语法

HRESULT GetConnectorIdConnectedTo(
  [out] LPWSTR *ppwstrConnectorId
);

参数

[out] ppwstrConnectorId

指向字符串指针的指针，方法在其中写入包含另一连接器全局 ID 的以 null 结尾的宽字符字符串的地址。 方法为字符串分配存储。 当不再需要存储时，调用方负责通过调用 CoTaskMemFree 函数来释放存储。 如果 GetConnectorIdConnectedTo 调用失败， 则 *ppwstrConnectorId 为 NULL。 有关 CoTaskMemFree 的信息，请参阅 Windows SDK 文档。

返回值

如果该方法成功，则它会返回 S_OK。 如果失败，可能的返回代码包括但不限于下表中显示的值。

返回代码 说明
E_NOTFOUND
 此连接器未连接，或者连接的另一端不是另一个设备拓扑 (例如，Software_IO连接) 。
E_POINTER
 参数 ppwstrConnectorId 为 NULL。
E_OUTOFMEMORY
 内存不足。

注解

全局 ID 是一个字符串，用于唯一标识系统中所有设备拓扑中所有部件中的某个部件。 客户端应将此字符串视为不透明。 也就是说，客户端不应尝试分析字符串的内容以获取有关部件的信息。 原因是字符串格式未定义，可能会从 DeviceTopology API 的一个实现更改为下一个实现。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 devicetopology.h

另请参阅

IConnector 接口