Funzione RtlGetVersion (wdm.h)
La routine RtlGetVersion restituisce informazioni sulla versione sul sistema operativo attualmente in esecuzione.
Sintassi
NTSYSAPI NTSTATUS RtlGetVersion(
[out] PRTL_OSVERSIONINFOW lpVersionInformation
);
Parametri
[out] lpVersionInformation
Puntatore a una struttura RTL_OSVERSIONINFOW o a una struttura RTL_OSVERSIONINFOEXW che contiene le informazioni sulla versione sul sistema operativo attualmente in esecuzione. Un chiamante specifica la struttura di input utilizzata impostando il membro dwOSVersionInfoSize della struttura sulle dimensioni in byte della struttura utilizzata.
Valore restituito
RtlGetVersion restituisce STATUS_SUCCESS.
Commenti
RtlGetVersion è l'equivalente in modalità kernel della funzione GetVersionEx in modalità utente in Windows SDK. Vedere l'esempio in Windows SDK che illustra come ottenere la versione di sistema.
Quando si usa RtlGetVersion per determinare se è in esecuzione una determinata versione del sistema operativo, un chiamante deve verificare la presenza di numeri di versione maggiori o uguali al numero di versione richiesto. In questo modo si garantisce che un test della versione abbia esito positivo per le versioni successive di Windows.
Poiché le funzionalità del sistema operativo possono essere aggiunte in una DLL ridistribuibile, controllare solo i numeri di versione principale e secondaria non è il modo più affidabile per verificare la presenza di una funzionalità di sistema specifica. Un driver deve usare RtlVerifyVersionInfo per verificare la presenza di una funzionalità di sistema specifica.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Ntddk.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |