IDebugControl4::GetSystemVersionString-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetSystemVersionString-Methode gibt eine Zeichenfolge zurück, die die Betriebssystemversion des Ziels beschreibt.

Syntax

HRESULT GetSystemVersionString(
  [in]            ULONG  Which,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG StringSize
);

Parameter

[in] Which

Gibt an, welche Versionszeichenfolge zurückgegeben werden soll. Die möglichen Werte sind in der folgenden Tabelle aufgeführt.

Wert	Versionszeichenfolge
DEBUG_SYSVERSTR_SERVICE_PACK	Gibt eine Beschreibung des Service Packs für das Betriebssystem des Ziels zurück. Beispiel: "Service Pack 1".
DEBUG_SYSVERSTR_BUILD	Gibt eine Beschreibung der Buildversion des Betriebssystems des Ziels zurück. Beispiel: "kernel32.dll Version: 5.1.2600.1106 (xpsp1.020828-1920)".

[out, optional] Buffer

Empfängt die Versionszeichenfolge. Wenn BufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Gibt die Größe des Puffers in Zeichen an, den Buffer angibt. Diese Größe enthält den Leerraum für das "\0"-Endzeichen.

[out, optional] StringSize

Empfängt die Größe der Zeichenfolge in Zeichen, die den Build identifiziert. Diese Größe enthält den Leerraum für das "\0"-Endzeichen. Wenn SizeStringNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Der Puffer war jedoch zu klein, sodass die Zeichenfolge abgeschnitten wurde.

Hinweise

Weitere Informationen finden Sie unter Zielinformationen.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (dbgeng.h einschließen)

Weitere Informationen

GetSystemVersion

GetSystemVersionValues

IDebugControl4

Freigeben über