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

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

注釈

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

ISearchCompletedCallback インターフェイスを実装する代わりに、スクリプトを使用して、オートメーション オブジェクトに DISPID 0 を持つ任意の識別子のコールバック ルーチンを実装できます。 onCompleted パラメーターの型は IUnknown* です。

アプリで非同期 WUA API を使用する場合は、タイムアウト メカニズムの実装が必要になる場合があります。 非同期 WUA 操作を実行する方法の詳細については、「 非同期 WUA 操作のガイドライン」を参照してください。

要件

こちらもご覧ください

IUpdateSearcher