IUPnPDescriptionDocument::Load メソッド (upnp.h)
Load メソッドは、ドキュメントを同期的に読み込みます。 このメソッドは、読み込み操作が完了するまで、呼び出し元に制御を返しません。
構文
HRESULT Load(
[in] BSTR bstrUrl
);
パラメーター
[in] bstrUrl
読み込むドキュメントの URL を指定します。
戻り値
メソッドが成功した場合、戻り値はS_OK。 それ以外の場合、メソッドは WinError.h で定義されている COM エラー コードの 1 つ、または次のいずれかの UPnP 戻り値を返します。
| リターン コード | 説明 |
|---|---|
|
XML ドキュメントにはデバイス要素がありません。 ルート要素または DeviceList 要素のどちらかにはありません。 |
|
指定した説明ドキュメントに Device 要素がありません。 |
|
XML ドキュメントに、Device 要素に必要な要素が 1 つありません。 |
|
XML ドキュメントにはアイコン要素がありません。 IconList 要素に存在しないか、DeviceList 要素に IconList 要素が含まれていません。 |
|
指定した説明ドキュメントに Icon 要素がありません。 |
|
XML ドキュメントに、Icon 要素に必要な要素の 1 つが見つかりません。 |
|
指定された説明ドキュメントにアイコン ノードがありません。 |
|
XML ドキュメントには、ドキュメントの最上位レベルにルート要素がありません。 |
|
指定した説明ドキュメントに Root 要素がありません。 |
|
XML ドキュメントにはサービス要素がありません。 ServiceList 要素に指定されていないか、DeviceList 要素に ServiceList 要素が含まれていません。 |
|
XML ドキュメントに、Service 要素に必要な要素が 1 つありません。 |
解説
このメソッドは、メソッドが返されるまでに長い時間がかかる可能性があるため、ユーザー インターフェイス スレッドから呼び出さないでください。
Load メソッドが Web ページ内のスクリプトによって呼び出される場合、bstrUrl は相対 URL である可能性があります。 現在の Web ページのアドレスがベース URL として使用されます。
このメソッドが Web ページから呼び出される場合、呼び出し元が指定する URL は、Web ページの読み込み元と同じサーバーを参照する必要があります。
要件
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | upnp.h |
| [DLL] | Upnp.dll |