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 エラーコードを返します。

このメソッドは、次のエラーコードを返すこともできます。

リターンコード	説明
E_POINTER	パラメーター値が無効または NULL です。
E_ACCESSDENIED	このメソッドは、リモートコンピューターから呼び出すことはできません。

検索条件の構文の詳細については、「検索」を参照してください。

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