IDebugControl2::GetSystemVersion-Methode (dbgeng.h)

Artikel
02/26/2024

Die GetSystemVersion-Methode gibt Informationen zurück, die das Betriebssystem auf dem Computer identifizieren, auf dem das aktuelle Ziel ausgeführt wird.

Syntax

HRESULT GetSystemVersion(
  [out]           PULONG PlatformId,
  [out]           PULONG Major,
  [out]           PULONG Minor,
  [out, optional] PSTR   ServicePackString,
  [in]            ULONG  ServicePackStringSize,
  [out, optional] PULONG ServicePackStringUsed,
  [out]           PULONG ServicePackNumber,
  [out, optional] PSTR   BuildString,
  [in]            ULONG  BuildStringSize,
  [out, optional] PULONG BuildStringUsed
);

Parameter

[out] PlatformId

Empfängt die Plattform-ID. PlatformId ist für NT-basiertes Windows immer VER_PLATFORM_WIN32_NT.

[out] Major

Empfängt 0xF, wenn das Betriebssystem des Ziels ein kostenloser Build ist, oder 0xC, wenn das Betriebssystem ein überprüfter Build ist.

[out] Minor

Empfängt die Buildnummer für das Betriebssystem des Ziels.

[out, optional] ServicePackString

Empfängt die Zeichenfolge für die Service Pack-Ebene des Zielcomputers. Wenn ServicePackStringNULL ist, werden diese Informationen nicht zurückgegeben. Wenn kein Service Pack installiert ist, kann ServicePackString leer sein.

[in] ServicePackStringSize

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

[out, optional] ServicePackStringUsed

Empfängt die Größe der Zeichenfolge der Service Pack-Ebene in Zeichen. Diese Größe enthält den Platz für das "\0"-Endzeichen. Wenn ServicePackStringUsedNULL ist, werden diese Informationen nicht zurückgegeben.

[out] ServicePackNumber

Empfängt die Service Pack-Ebene des Betriebssystems des Ziels.

[out, optional] BuildString

Empfängt die Zeichenfolge, die den Build des Systems identifiziert. Wenn BuildStringNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BuildStringSize

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

[out, optional] BuildStringUsed

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

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Der ServicePackString-Puffer oder der BuildString-Puffer waren jedoch zu klein, und die entsprechende Zeichenfolge wurde abgeschnitten.