IUPnPDeviceFinderCallback::SearchComplete メソッド (upnp.h)
SearchComplete メソッドは、ネットワーク デバイスの最初の検索が完了したことをアプリケーションに通知するために、UPnP フレームワークによって呼び出されます。
このメソッドは、UPnP フレームワークが IUPnPDeviceFinderCallback::D eviceAdded または IUPnPDeviceFinderAddCallbackWithInterface::D eviceAddedWithInterface コールバックの送信を完了したときに呼び出されます。 これらのコールバックは、検索が開始された時点のネットワークの状態を反映します。
構文
HRESULT SearchComplete(
[in] LONG lFindData
);
パラメーター
[in] lFindData
UPnP フレームワークが結果を返す検索を指定します。 lFindData の値は、IUPnPDeviceFinder::CreateAsyncFind によって呼び出し元に返される値です。
戻り値
アプリケーションはS_OKを返す必要があります。
注釈
このメソッドは単に情報を提供します。 非同期検索が終了したことを示すのではなく、初期プローブが完了したことを示します。 非同期検索では、アプリケーションが IUPnPDeviceFinder::CancelAsyncFind を呼び出すまで、ネットワークに追加されているデバイスとネットワークから削除されているデバイスが引き続き報告されます。
最初の検索が完了するまでに長い時間がかかる場合があります。 SearchComplete コールバックは、最後のデバイスの説明ドキュメント (つまり、検索の開始時にネットワーク上に存在する最後のデバイス) が読み込まれたか、読み込みに失敗したときに呼び出されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | upnp.h |
| [DLL] | Upnp.dll |