Structure OSVERSIONINFOA (winnt.h)

Contient des informations sur la version du système d’exploitation. Les informations incluent les numéros de version principale et mineure, un numéro de build, un identificateur de plateforme et un texte descriptif sur le système d’exploitation. Cette structure est utilisée avec la fonction GetVersionEx .

Pour obtenir des informations de version supplémentaires, utilisez plutôt la structure OSVERSIONINFOEX avec GetVersionEx .

Syntaxe

typedef struct _OSVERSIONINFOA {
  DWORD dwOSVersionInfoSize;
  DWORD dwMajorVersion;
  DWORD dwMinorVersion;
  DWORD dwBuildNumber;
  DWORD dwPlatformId;
  CHAR  szCSDVersion[128];
} OSVERSIONINFOA, *POSVERSIONINFOA, *LPOSVERSIONINFOA;

Membres

dwOSVersionInfoSize

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

dwMajorVersion

Numéro de version principal du système d’exploitation. Pour plus d'informations, consultez la section Notes.

dwMinorVersion

Numéro de version secondaire du système d’exploitation. Pour plus d'informations, consultez la section Notes.

dwBuildNumber

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

dwPlatformId

Plateforme du système d’exploitation. Ce membre peut être la valeur suivante.

szCSDVersion[128]

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

Remarques

S’appuyer sur les informations de version n’est pas la meilleure façon de tester une fonctionnalité. Au lieu de cela, reportez-vous à la documentation pour connaître la fonctionnalité qui vous intéresse. Pour plus d’informations sur les techniques courantes de détection des fonctionnalités, consultez Version du système d’exploitation.

Si vous devez avoir besoin d’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. De cette façon, votre code de détection continuera à fonctionner sur les versions futures 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 « Autre » pour faire la distinction entre les systèmes d’exploitation avec des numéros de version identiques.

Exemples

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

Configuration requise

Voir aussi

OSVERSIONINFOEX

API d’assistance de version