IUpdateSearcher::BeginSearch メソッド (wuapi.h)
更新プログラムの非同期検索の実行を開始します。 この検索では、現在構成されている検索オプションが使用されます。
構文
HRESULT BeginSearch(
[in] BSTR criteria,
[in] IUnknown *onCompleted,
[in] VARIANT state,
[out] ISearchJob **retval
);
パラメーター
[in] criteria
検索条件を指定する文字列。
[in] onCompleted
非同期検索操作が完了したときに呼び出 される ISearchCompletedCallback インターフェイス。
[in] state
ISearchJob インターフェイスの AsyncState プロパティによって返される呼び出し元固有の状態。
[out] retval
保留中の可能性がある現在の操作を表す ISearchJob インターフェイス。
呼び出し元は、返された値を EndSearch メソッドに渡して、検索操作を完了します。
戻り値
成功した場合 は、S_OK を返します。 それ以外の場合は、COM または Windows エラー コードを返します。
このメソッドは、次のエラー コードを返すこともできます。
| リターン コード | 説明 |
|---|---|
|
パラメーター値が無効または NULL です。 |
|
このメソッドは、リモート コンピューターから呼び出すことはできません。 |
注釈
検索条件の構文の詳細については、「 検索」を参照してください。
ISearchCompletedCallback インターフェイスを実装する代わりに、スクリプトを使用して、オートメーション オブジェクトに DISPID 0 を持つ任意の識別子のコールバック ルーチンを実装できます。 onCompleted パラメーターの型は IUnknown* です。
アプリで非同期 WUA API を使用する場合は、タイムアウト メカニズムの実装が必要になる場合があります。 非同期 WUA 操作を実行する方法の詳細については、「 非同期 WUA 操作のガイドライン」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP、Windows 2000 Professional sp3 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003、Windows 2000 Server SP3 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wuapi.h |
| Library | Wuguid.lib |
| [DLL] | Wuapi.dll |