IUPnPDescriptionDocument::RootDevice メソッド (upnp.h)
RootDevice メソッドは、現在読み込まれているドキュメントのデバイス ツリーのルート デバイスを返します。
構文
HRESULT RootDevice(
[out] IUPnPDevice **ppudRootDevice
);
パラメーター
[out] ppudRootDevice
デバイスを記述する IUPnPDevice オブジェクトへの参照を受け取ります。 この参照は、不要になったときにリリースする必要があります。
戻り値
メソッドが成功した場合、戻り値はS_OK。 それ以外の場合、メソッドは WinError.h で定義されている COM エラー コードのいずれかを返します。
注釈
デバイスの説明が最初に IUPnPDescriptionDocument::Load または IUPnPDescriptionDocument::LoadAsync を使用して読み込まれる場合を除き、RootDevice を使用しないでください。 検索操作では、現在読み込まれているデバイスの説明のみが検索されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | upnp.h |
| [DLL] | Upnp.dll |