IUPnPRegistrar：：GetUniqueDeviceName 方法 (upnphost.h)

GetUniqueDeviceName 方法會擷取指定裝置的 UDN。 UDN 是由每個內嵌裝置的裝置主機所產生。裝置描述中的範本 UDN 會取代為註冊裝置時，針對每個內嵌裝置產生的 UDN。這個方法已重新進入。

語法

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

[in] bstrDeviceIdentifier

指定 RegisterDevice 或 RegisterRunningDevice 所傳回的標識符。

[in] bstrTemplateUDN

從裝置描述範本指定 UDN。

[out] pbstrUDN

接收裝置主機所產生的裝置 UDN。

如果方法成功，傳回值會S_OK。否則，方法會傳回 WinError.h 中定義的其中一個 COM 錯誤碼。

在註冊期間，會取代裝置描述範本中為裝置指定的每個 UDN。裝置主機會將每個 UDN 取代為全域唯一的 UDN。