RtlGetVersion fonction)

Obtient des informations de version sur le système d’exploitation en cours d’exécution.

Syntaxe

NTSTATUS RtlGetVersion(
  _Out_ PRTL_OSVERSIONINFOW lpVersionInformation
);

Paramètres

lpVersionInformation [ à]

Pointeur vers une structure _ OSVERSIONINFOW RTL ou une structure _ OSVERSIONINFOEXW RTL qui contient les informations de version relatives au système d’exploitation en cours d’exécution. Un appelant spécifie la structure d’entrée utilisée en affectant à la taille du membre dwOSVersionInfoSize de la structure la taille en octets de la structure utilisée.

Valeur retournée

Retourne l’état _ réussite.

Remarques

RtlGetVersion est l’équivalent de la fonction GetVersionEx dans le SDK Windows. consultez l’exemple dans le SDK Windows qui montre comment obtenir la version du système.

Quand vous utilisez RtlGetVersion pour déterminer si une version particulière du système d’exploitation est en cours d’exécution, un appelant doit vérifier les numéros de version qui sont supérieurs ou égaux au numéro de version requis. Cela garantit qu’un test de version est correctement effectué pour les versions ultérieures de Windows.

Étant donné que les fonctionnalités du système d’exploitation peuvent être ajoutées à une DLL redistribuable, la vérification des numéros de version majeure et mineure n’est pas la méthode la plus fiable pour vérifier la présence d’une fonctionnalité système spécifique. Un pilote doit utiliser RtlVerifyVersionInfo pour tester la présence d’une fonctionnalité système spécifique.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel - [Applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server - [Applications de bureau uniquement]
Plateforme cible
Universal
En-tête
Ntddk. h (inclure Ntddk. h)
Bibliothèque
Ntdll. lib ;
NtosKrnl. lib
DLL
Ntdll.dll ;
NtosKrnl.exe

Voir aussi

PsGetVersion