RtlGetVersion-Funktion

Ruft Versionsinformationen zum derzeit ausgeführten Betriebssystem ab.

Syntax

NTSTATUS RtlGetVersion(
  _Out_ PRTL_OSVERSIONINFOW lpVersionInformation
);

Parameter

lpVersionInformation [out]

Zeiger auf eine RTL_OSVERSIONINFOW-Struktur oder eine RTL_OSVERSIONINFOEXW-Struktur , die die Versionsinformationen zum derzeit ausgeführten Betriebssystem enthält. Ein Aufrufer gibt an, welche Eingabestruktur verwendet wird, indem der dwOSVersionInfoSize-Member der Struktur auf die Größe in Byte der verwendeten Struktur festgelegt wird.

Rückgabewert

Gibt STATUS_SUCCESS zurück.

Bemerkungen

RtlGetVersion ist die Entsprechung der GetVersionEx-Funktion im Windows SDK. Sehen Sie sich das Beispiel im Windows SDK an, das zeigt, wie Sie die Systemversion abrufen.

Wenn Sie RtlGetVersion verwenden, um zu bestimmen, ob eine bestimmte Version des Betriebssystems ausgeführt wird, sollte ein Aufrufer nach Versionsnummern suchen, die größer oder gleich der erforderlichen Versionsnummer sind. Dadurch wird sichergestellt, dass ein Versionstest für spätere Versionen von Windows erfolgreich ist.

Da Betriebssystemfeatures in einer verteilbaren DLL hinzugefügt werden können, ist die Überprüfung nur der Haupt- und Nebenversionsnummern nicht die zuverlässigste Methode, um das Vorhandensein eines bestimmten Systemfeatures zu überprüfen. Ein Treiber sollte RtlVerifyVersionInfo verwenden, um zu testen, ob ein bestimmtes Systemfeature vorhanden ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Universell
Header	Ntddk.h (ntddk.h einschließen)
Bibliothek	Ntdll.lib; NtosKrnl.lib
DLL	Ntdll.dll; NtosKrnl.exe

Siehe auch

PsGetVersion