IDebugControl::GetSystemVersion-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetSystemVersion Methode gibt Informationen zurück, die das Betriebssystem auf dem Computer identifiziert, 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- wird für NT-basierte Windows immer VER_PLATFORM_WIN32_NT.

[out] Major

Empfängt 0xF, wenn das Betriebssystem des Ziels ein kostenloser Buildist, oder 0xC, wenn das Betriebssystem ein überprüftes 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 ServicePackString-NULL-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, der ServicePackString- angibt. Diese Größe enthält den Abstand für das Endzeichen '\0'.

[out, optional] ServicePackStringUsed

Empfängt die Größe der Zeichenfolge der Service Pack-Ebene in Zeichen. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn ServicePackStringUsed-NULL-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 BuildString-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] BuildStringSize

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

[out, optional] BuildStringUsed

Empfängt die Größe in Zeichen der Zeichenfolge, die den Build identifiziert. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn BuildStringUsed-NULL-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.