IUpdateSession3::QueryHistory メソッド (wuapi.h)

更新イベントの履歴をコンピューターに同期的に照会します。 このメソッドは、コンピューター上の一致するイベント レコードを含む IUpdateHistoryEntryCollection インターフェイスへのポインターを返します。

構文

HRESULT QueryHistory(
  [in]  BSTR                          criteria,
  [in]  LONG                          startIndex,
  [in]  LONG                          count,
  [out] IUpdateHistoryEntryCollection **retval
);

パラメーター

[in] criteria

検索条件を指定する文字列。

[in] startIndex

取得する最初のイベントのインデックス。

[in] count

取得するイベントの数。

[out] retval

コンピューター上の一致するイベント レコードを時系列順に含む IUpdateHistoryEntryCollection インターフェイスへのポインター。

戻り値

成功した場合 は、S_OK を返します。 それ以外の場合は、COM または Windows エラー コードを返します。

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

リターン コード	説明
E_POINTER	パラメーター値が無効または NULL です。
WU_E_INVALID_CRITERIA	無効な検索条件があります。

注釈

返されるイベントのコレクションは、降順で日付で並べ替えられます。

criteria パラメーターに使用される文字列は、QueryHistory のカスタム検索言語と一致している必要があります。 文字列には、返す履歴イベントを決定するために評価される条件が含まれています。

QueryHistory ではマシンごとの更新のみがサポートされることに注意してください。

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

次の表は、すべてのパブリック サポート条件を評価の優先順位で示しています。 今後、この一覧にさらに条件が追加される可能性があります。

条件	型	使用可能な演算子	説明
UpdateID	string(UUID)	=	指定した値の UpdateIdentity.UpdateID を持つ更新プログラムを検索します。 たとえば、"UpdateID='12345678-9abc-def0-1234-56789abcdef0'" は、12345678-9abc-def0-1234-56789abcdef0 と等しい UpdateIdentity.UpdateID の更新プログラムを検索します。

要件

サポートされている最小のクライアント	Windows XP、Windows 2000 Professional sp3 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003、Windows 2000 Server SP3 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	wuapi.h
Library	Wuguid.lib
[DLL]	Wuapi.dll

こちらもご覧ください

IUpdateSession3