IUPnPRegistrar：：GetUniqueDeviceName 方法 (upnphost.h)

GetUniqueDeviceName 方法检索指定设备的 UDN。 UDN 已由设备主机为每个嵌入式设备生成。设备说明中的模板 UDN 将替换为注册设备时为每个嵌入式设备生成的 UDN。此方法可重新进入。

语法

HRESULT GetUniqueDeviceName(
  [in]  BSTR bstrDeviceIdentifier,
  [in]  BSTR bstrTemplateUDN,
  [out] BSTR *pbstrUDN
);

[in] bstrDeviceIdentifier

[in] bstrTemplateUDN

指定设备说明模板中的 UDN。

[out] pbstrUDN

接收设备主机生成的设备的 UDN。

如果方法成功，则返回值S_OK。否则，方法将返回 WinError.h 中定义的 COM 错误代码之一。

在注册期间，将替换设备说明模板中为设备指定的每个 UDN。设备主机将每个 UDN 替换为全局唯一的 UDN。