OSVERSIONINFOEXW-Struktur (wdm.h)

Die RTL_OSVERSIONINFOEXW-Struktur enthält Informationen zur Betriebssystemversion.

Syntax

typedef struct _OSVERSIONINFOEXW {
  ULONG  dwOSVersionInfoSize;
  ULONG  dwMajorVersion;
  ULONG  dwMinorVersion;
  ULONG  dwBuildNumber;
  ULONG  dwPlatformId;
  WCHAR  szCSDVersion[128];
  USHORT wServicePackMajor;
  USHORT wServicePackMinor;
  USHORT wSuiteMask;
  UCHAR  wProductType;
  UCHAR  wReserved;
} OSVERSIONINFOEXW, *POSVERSIONINFOEXW, *LPOSVERSIONINFOEXW, RTL_OSVERSIONINFOEXW, *PRTL_OSVERSIONINFOEXW;

Member

dwOSVersionInfoSize

Die Größe einer RTL_OSVERSIONINFOEXW-Struktur in Bytes. Dieser Member muss festgelegt werden, bevor die Struktur mit RtlGetVersion verwendet wird.

dwMajorVersion

Die Hauptversionsnummer des Betriebssystems. Für Windows 2000 ist die Hauptversionsnummer beispielsweise fünf. Weitere Informationen finden Sie in der Tabelle unter Hinweise.

dwMinorVersion

Die Nebenversionsnummer des Betriebssystems. Für Windows 2000 ist die Nebenversionsnummer beispielsweise 0 (null). Weitere Informationen finden Sie in der Tabelle unter Hinweise.

dwBuildNumber

Die Buildnummer des Betriebssystems.

dwPlatformId

Die Betriebssystemplattform. Für Win32 unter NT-basierten Betriebssystemen gibt RtlGetVersion den Wert VER_PLATFORM_WIN32_NT zurück.

szCSDVersion[128]

Die Service Pack-Versionszeichenfolge. Dieses Element enthält eine NULL-endende Zeichenfolge, z. B. "Service Pack 3", die das neueste Service Pack angibt, das auf dem System installiert ist. Wenn kein Service Pack installiert ist, initialisiert RtlGetVersion diese Zeichenfolge möglicherweise nicht. Initialisieren Sie szCSDVersion vor dem Aufruf von RtlGetVersion auf null (leere Zeichenfolge).

wServicePackMajor

Die Hauptversionsnummer des neuesten Service Packs, das auf dem System installiert ist. Für Service Pack 3 ist die Hauptversionsnummer beispielsweise drei. Wenn kein Service Pack installiert wurde, ist der Wert null.

wServicePackMinor

Die Nebenversionsnummer des zuletzt auf dem System installierten Service Packs. Beispielsweise ist für Service Pack 3 die Nebenversionsnummer 0 (null).

wSuiteMask

Die im System verfügbaren Produktsammlungen. Dieser Member ist auf null oder auf das bitweise OR eines oder mehrerer der folgenden Werte festgelegt.

Sie sollten sich nicht ausschließlich auf das flag VER_SUITE_SMALLBUSINESS verlassen, um zu bestimmen, ob Small Business Server derzeit installiert ist. Sowohl dieses Flag als auch das VER_SUITE_SMALLBUSINESS_RESTRICTED-Flag werden festgelegt, wenn diese Produktsammlung installiert wird. Wenn Sie diese Installation auf Windows Server Standard Edition aktualisieren, wird das flag VER_SUITE_SMALLBUSINESS_RESTRICTED deaktiviert, aber das flag VER_SUITE_SMALLBUSINESS bleibt festgelegt, was in diesem Fall angibt, dass Small Business Server zuvor auf diesem System installiert wurde. Wenn diese Installation auf Windows Server Enterprise Edition aktualisiert wird, bleibt das flag VER_SUITE_SMALLBUSINESS festgelegt.

wProductType

Der Produkttyp. Dieser Member enthält zusätzliche Informationen zum System. Dieser Member kann einer der folgenden Werte sein:

wReserved

Für die zukünftige Verwendung reserviert.

Bemerkungen

Die Informationen in dieser Struktur umfassen die Haupt- und Nebenversionsnummern, die Buildnummer, die Plattform-ID, die installierten Produktsammlungen und das neueste Service Pack, das auf dem System installiert ist. Diese Struktur wird mit den Routinen RtlGetVersion und RtlVerifyVersionInfo verwendet.

Die Verwendung von Versionsinformationen ist nicht immer die beste Möglichkeit, um zu testen, ob ein Feature verfügbar ist. Weitere Informationen finden Sie in der Dokumentation für das Feature, an dem Sie interessiert sind.

Entwerfen Sie nach Möglichkeit den Versionserkennungscode in Ihrem Treiber, damit der Treiber unter zukünftigen Windows-Versionen ausgeführt werden kann. Wenn Ihr Treiber eine bestimmte Betriebssystemversion erfordert, sollten Sie diese Version als unterstützte Mindestversion und nicht als einzige Version behandeln, unter der der Treiber ausgeführt werden kann.

In der folgenden Tabelle sind die Versionsinformationen zusammengefasst, die von unterstützten Versionen von Windows zurückgegeben werden. Verwenden Sie die Informationen in der Spalte "Sonstige" oder Buildnummer, um zwischen Betriebssystemen mit identischen Versionsnummern zu unterscheiden.

Nur ein 64-Bit-Kernelmodustreiber kann unter Windows XP Professional x64 Edition ausgeführt werden. Daher kann ein 32-Bit-Kernelmodustreiber die Überprüfung auf diese Version von Windows problemlos auslassen.

Anforderungen

Weitere Informationen

RTL_OSVERSIONINFOW

RtlGetVersion

RtlVerifyVersionInfo