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 錯誤碼。

此方法也可以傳回下列錯誤碼。

傳回碼	Description
E_POINTER	參數值無效或 NULL。
WU_E_INVALID_CRITERIA	搜尋準則無效。

備註

傳回的事件集合會依日期的遞減順序排序。

用於 criteria 參數的字串必須符合 QueryHistory 的自定義搜尋語言。 字串包含評估的準則，以判斷要傳回的記錄事件。

請注意， QueryHistory 僅支援每部計算機更新。

如需搜尋準則語法的完整描述，請參閱 搜尋。

下表會依評估優先順序來識別所有公用支援準則。 未來可能會將更多準則新增至此清單。

條件	類型	允許的運算子	Description
UpdateID	string (UUID)	=	尋找具有指定值 之 UpdateIdentity.UpdateID 的更新 。 例如，“UpdateID='12345678-9abc-def0-1234-56789abcdef0'” 會尋找 UpdateIdentity.UpdateID 的更新 ，其等於 12345678-9abc-def0-1234-56789abcdef0。

規格需求

最低支援的用戶端	Windows XP、Windows 2000 Professional 與 SP3 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003、Windows 2000 Server 與 SP3 [僅限桌面應用程式]
目標平台	Windows
標頭	wuapi.h
程式庫	Wuguid.lib
Dll	Wuapi.dll

另請參閱

IUpdateSession3