IWSDiscoveryProviderNotify::SearchFailed メソッド (wsddisco.h)
ユーザーが開始した検索が失敗したことを示すために呼び出されます。
構文
HRESULT SearchFailed(
[in] HRESULT hr,
[in, optional] LPCWSTR pszTag
);
パラメーター
[in] hr
このコールバックを開始した検索エラーの原因。 値 S_FALSE は、Add コールバックを発行せずに検索が完了したことを示します。
[in, optional] pszTag
この検索の省略可能な識別子タグ。 NULL を指定できます。
戻り値
戻り値は意味がありません。 実装者は 、S_OKを返す必要があります。
注釈
SearchComplete は、応答が正常に受信された場合に呼び出されます。
SearchFailed は、ユーザーが開始したクエリで応答が発生しない場合に呼び出されます。 この場合、 hr パラメーターの値はS_FALSEされます。 クエリ転送が必ずしも同期的であるとは限らないため、クエリの送信試行でエラーが発生した場合は、SearchFailed を必要に応じて呼び出すことができます。 pszTag は、クエリからユーザーが指定したタグと一致するため、失敗したクエリを識別するために使用する必要があります。
SearchByType または SearchById を使用して検索を開始してから SearchFailed 通知を受信するまでの間隔は、WS-Discovery からのMATCH_TIMEOUTに基づき、DPWS 付録 I によって修正された最大 10 秒です。SearchByAddress を使用して検索を開始してから SearchFailed 通知を受信するまでの間隔は通常 21 秒ですが、最大 150 秒にすることができます。
メモ プロバイダーによって SearchFailed に対して複数の同時呼び出しが行われる可能性があるため、このコールバックで共有データを同期することが不可欠です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wsddisco.h (Wsdapi.h を含む) |
| [DLL] | Wsdapi.dll |