RtlGetVersion-Funktion (wdm.h)
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 |