IUpdateSession3::QueryHistory-Methode (wuapi.h)

Artikel
01/27/2024

Fragt den Computer synchron nach dem Verlauf von Updateereignissen ab. Diese Methode gibt einen Zeiger auf eine IUpdateHistoryEntryCollection-Schnittstelle zurück, die übereinstimmende Ereignisdatensätze auf dem Computer enthält.

Syntax

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

Parameter

[in] criteria

Eine Zeichenfolge, die die Suchkriterien angibt.

[in] startIndex

Der Index des ersten abzurufenden Ereignisses.

[in] count

Die Anzahl der abzurufenden Ereignisse.

[out] retval

Ein Zeiger auf eine IUpdateHistoryEntryCollection-Schnittstelle , die die übereinstimmenden Ereignisdatensätze auf dem Computer in absteigender chronologischer Reihenfolge enthält.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Andernfalls wird ein COM- oder Windows-Fehlercode zurückgegeben.

Diese Methode kann auch die folgenden Fehlercodes zurückgeben.

Rückgabecode	Beschreibung
E_POINTER	Ein Parameterwert ist ungültig oder NULL.
WU_E_INVALID_CRITERIA	Es gibt ungültige Suchkriterien.

Hinweise

Die Auflistung der zurückgegebenen Ereignisse wird nach dem Datum in absteigender Reihenfolge sortiert.

Die Zeichenfolge, die für den Criteria-Parameter verwendet wird, muss mit der benutzerdefinierten Suchsprache für QueryHistory übereinstimmen. Die Zeichenfolge enthält Kriterien, die ausgewertet werden, um zu bestimmen, welche Verlaufsereignisse zurückgegeben werden sollen.

Beachten Sie, dass QueryHistory nur computerspezifische Updates unterstützt.

Eine vollständige Beschreibung der Suchkriteriensyntax finden Sie unter Suchen.

In der folgenden Tabelle werden alle Kriterien für die öffentliche Unterstützung in der Reihenfolge der Bewertungsrangfolge aufgeführt. Dieser Liste können in Zukunft weitere Kriterien hinzugefügt werden.

Kriterium	Typ	Zulässige Operatoren	BESCHREIBUNG
UpdateID	string(UUID)	=	Sucht Nach Updates, die über eine UpdateIdentity.UpdateID des angegebenen Werts verfügen. Beispielsweise findet "UpdateID='12345678-9abc-def0-1234-56789abcdef0'" Updates für UpdateIdentity.UpdateID , die 12345678-9abc-def0-1234-56789abcdef0 entsprechen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wuapi.h
Bibliothek	Wuguid.lib
DLL	Wuapi.dll

Weitere Informationen

IUpdateSession3

Freigeben über