OSVERSIONINFOEXA, structure (winnt.h)

Contient les informations de version du système d’exploitation. Les informations incluent des numéros de version majeure et mineure, un numéro de build, un identificateur de plateforme et des informations sur les suites de produits et le dernier Service Pack installé sur le système. Cette structure est utilisée avec les fonctions GetVersionEx et VerifyVersionInfo.

Syntaxe

typedef struct _OSVERSIONINFOEXA {
  DWORD dwOSVersionInfoSize;
  DWORD dwMajorVersion;
  DWORD dwMinorVersion;
  DWORD dwBuildNumber;
  DWORD dwPlatformId;
  CHAR  szCSDVersion[128];
  WORD  wServicePackMajor;
  WORD  wServicePackMinor;
  WORD  wSuiteMask;
  BYTE  wProductType;
  BYTE  wReserved;
} OSVERSIONINFOEXA, *POSVERSIONINFOEXA, *LPOSVERSIONINFOEXA;

Membres

dwOSVersionInfoSize

Taille de cette structure de données, en octets. Définissez ce membre sur sizeof(OSVERSIONINFOEX).

dwMajorVersion

Numéro de version principal du système d’exploitation. Pour plus d’informations, consultez Remarques.

dwMinorVersion

Numéro de version secondaire du système d’exploitation. Pour plus d’informations, consultez Remarques.

dwBuildNumber

Numéro de build du système d’exploitation.

dwPlatformId

Plateforme du système d’exploitation. Ce membre peut être VER_PLATFORM_WIN32_NT (2).

szCSDVersion[128]

Chaîne terminée par null, telle que « Service Pack 3 », qui indique la dernière version de Service Pack installée sur le système. Si aucun Service Pack n’a été installé, la chaîne est vide.

wServicePackMajor

Numéro de version principal du dernier Service Pack installé sur le système. Par exemple, pour Service Pack 3, le numéro de version principale est 3. Si aucun Service Pack n’a été installé, la valeur est égale à zéro.

wServicePackMinor

Numéro de version secondaire du dernier Service Pack installé sur le système. Par exemple, pour Service Pack 3, le numéro de version mineure est 0.

wSuiteMask

Masque de bits qui identifie les suites de produits disponibles sur le système. Ce membre peut être une combinaison des valeurs suivantes.

wProductType

Informations supplémentaires sur le système. Ce membre peut être l’une des valeurs suivantes.

wReserved

Réservé pour une utilisation ultérieure.

Remarques

L’utilisation des informations de version n’est pas la meilleure façon de tester une fonctionnalité. Au lieu de cela, reportez-vous à la documentation relative à la fonctionnalité d’intérêt. Pour plus d’informations sur les techniques courantes de détection des fonctionnalités, consultez version du système d’exploitation.

Si vous devez exiger un système d’exploitation particulier, veillez à l’utiliser comme version minimale prise en charge, plutôt que de concevoir le test pour le système d’exploitation unique. Ainsi, votre code de détection continuera de fonctionner sur les futures versions de Windows.

Le tableau suivant récapitule les valeurs retournées par les versions prises en charge de Windows. Utilisez les informations de la colonne intitulée « Other » pour faire la distinction entre les systèmes d’exploitation avec des numéros de version identiques.

Vous ne devez pas vous appuyer uniquement sur l’indicateur de VER_SUITE_SMALLBUSINESS pour déterminer si Small Business Server a été installé sur le système, car cet indicateur et l’indicateur de VER_SUITE_SMALLBUSINESS_RESTRICTED sont définis lorsque cette suite de produits est installée. Si vous mettez à niveau cette installation vers Windows Server, Standard Edition, l’indicateur VER_SUITE_SMALLBUSINESS_RESTRICTED sera effacé. Toutefois, l’indicateur VER_SUITE_SMALLBUSINESS reste défini. Dans ce cas, cela indique que Small Business Server a été installé une fois sur ce système. Si cette installation est mise à niveau vers Windows Server, Enterprise Edition, l’indicateur VER_SUITE_SMALLBUSINESS reste défini.

Si le mode de compatibilité est en vigueur, la structure OSVERSIONINFOEX contient des informations sur le système d’exploitation sélectionné pour compatibilité des applications.

Pour déterminer si une application Win32 s’exécute sur WOW64, appelez la fonction IsWow64Process. Pour déterminer si le système exécute une version 64 bits de Windows, appelez la fonction GetNativeSystemInfo.

La fonction getSystemMetrics fournit les informations supplémentaires suivantes sur le système d’exploitation actuel.

Exemples

Pour obtenir un exemple, consultez Obtention de la version système.

Exigences

Voir aussi

IsWow64Process

osVERSIONINFO

API d’assistance de version