RtlGetVersion-Funktion (wdm.h)

  • Artikel

Die RtlGetVersion-Routine gibt Versionsinformationen zum derzeit ausgeführten Betriebssystem zurück.

Syntax

NTSYSAPI NTSTATUS RtlGetVersion(
  [out] PRTL_OSVERSIONINFOW lpVersionInformation
);

Parameter

[out] lpVersionInformation

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

RtlGetVersion gibt STATUS_SUCCESS zurück.

Hinweise

RtlGetVersion ist die Kernelmodus-Entsprechung der GetVersionEx-Funktion im Benutzermodus 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) Verfügbar ab Windows 2000.
Zielplattform Universell
Header wdm.h (ntddk.h einschließen)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Weitere Informationen

PsGetVersion