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 をグローバルに一意のものに置き換えます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | upnphost.h |
| [DLL] | Upnphost.dll |