Freigeben über


IWindowsUpdateAgentInfo::GetInfo-Methode (wuapi.h)

Ruft Versionsinformationen zu Windows Update Agent (WUA) ab.

Syntax

HRESULT GetInfo(
  [in]  VARIANT varInfoIdentifier,
  [out] VARIANT *retval
);

Parameter

[in] varInfoIdentifier

Ein Literalzeichenfolgenwert, der den Typ der Vom retval-Parameter zurückgegebenen Informationen angibt. In der folgenden Tabelle sind die aktuellen möglichen Zeichenfolgenwerte aufgeführt.

ApiMajorVersion Ruft die aktuelle Hauptversion von WUA ab.
ApiMinorVersion Ruft die aktuelle Nebenversion von WUA ab.
ProductVersionString Ruft die Dateiversion der Wuapi.dll-Datei im Zeichenfolgenformat ab.

[out] retval

  • Gibt die Hauptversion der WUA-API als LONG-Wert innerhalb der VARIANT-Variablen zurück, wenn der Wert des varInfoIdentifier-ParametersApiMajorVersion ist.
  • Gibt die Nebenversion der WUA-API als LONG-Wert innerhalb der VARIANT-Variablen zurück, wenn der Wert von varInfoIdentifierApiMinorVersion ist.
  • Gibt die Dateiversion der Wuapi.dll Datei als BSTR-Wert innerhalb der VARIANT-Variablen zurück, wenn der Wert von varInfoIdentifierProductVersionString ist.
Hinweis Das Format einer zurückgegebenen Zeichenfolge lautet wie folgt: "<Windows-Hauptversion>.<Windows-Nebenversion>. <build>.<aktualisieren>".
 

Rückgabewert

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

Fehlercode.

Hinweise

Für die IWindowsUpdateAgentInfo-Schnittstelle müssen Sie möglicherweise WUA aktualisieren. Weitere Informationen finden Sie unter Aktualisieren Windows Update-Agents.

Die Hauptversion wird für jedes Release einmal erhöht, wenn eine Änderung an den Schnittstellen der WUA-API auftritt. Die Nebenversion wird für jedes Release einmal erhöht, wenn eine Änderung an den vorhandenen Schnittstellen der WUA-API auftritt.

Anforderungen

Anforderung Wert
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

IWindowsUpdateAgentInfo