Structure CLUSTERVERSIONINFO (clusapi.h)

Article
08/22/2023

Décrit des informations sur la version du service de cluster installé localement sur un nœud.

Syntaxe

typedef struct CLUSTERVERSIONINFO {
  DWORD dwVersionInfoSize;
  WORD  MajorVersion;
  WORD  MinorVersion;
  WORD  BuildNumber;
  WCHAR szVendorId[64];
  WCHAR szCSDVersion[64];
  DWORD dwClusterHighestVersion;
  DWORD dwClusterLowestVersion;
  DWORD dwFlags;
  DWORD dwReserved;
} CLUSTERVERSIONINFO, *LPCLUSTERVERSIONINFO, *PCLUSTERVERSIONINFO;

Membres

dwVersionInfoSize

Taille, en octets, de la structure de données. Les utilisateurs doivent définir cette taille avant d’appeler GetClusterInformation.

MajorVersion

Identifie le numéro de version principale du système d’exploitation installé sur le nœud local. Par exemple, pour la version X.Y, le numéro de version principale est X.

MinorVersion

Identifie le numéro de version mineure du système d’exploitation installé sur le nœud local. Par exemple, pour la version X.Y, le numéro de version secondaire est Y.

BuildNumber

Identifie le numéro de build du système d’exploitation installé sur le nœud local, par exemple 224.

szVendorId[64]

Contient les informations d’identificateur de fournisseur pour le service de cluster installé sur le nœud local.

szCSDVersion[64]

Contient le dernier Service Pack installé sur le nœud. Si aucun Service Pack n’a été installé, le membre szCSDVersion est vide.

dwClusterHighestVersion

Identifie la version la plus élevée du service de cluster à laquelle le service de cluster installé sur le nœud local peut se joindre pour former un cluster.

dwClusterLowestVersion

Identifie la version la plus basse du service de cluster à laquelle le service de cluster installé sur le nœud local peut se joindre pour former un cluster.

dwFlags

Si les nœuds de cluster exécutent différentes versions du service cluster, cette valeur est définie sur CLUSTER_VERSION_FLAG_MIXED_MODE. Si tous les nœuds de cluster exécutent la même version du service cluster, cette valeur est 0.

dwReserved

Cette valeur est réservée à un usage interne.

Remarques

Pour obtenir des informations sur la version du cluster, les applications déclarent une structure CLUSTERVERSIONINFO , spécifient la taille de la structure dans le membre dwVersionInfoSize et appellent la fonction GetClusterInformation . GetClusterInformation remplit les données membres de la structure.

Pour éviter les remplacements pour toutes les combinaisons possibles d’informations de version, définissez toujours dwVersionInfoSize sur :

sizeof(CLUSTERVERSIONINFO)

Les valeurs dwClusterHighestVersion et dwClusterLowestVersion indiquent si le nœud local peut se joindre à un autre nœud pour former un cluster. Une jointure peut réussir si l’une des conditions suivantes est remplie :

La version la plus élevée du nœud local correspond exactement à la version la plus élevée de l’autre nœud.
La version la plus basse du nœud local correspond exactement à la version la plus élevée de l’autre nœud.
La version la plus élevée du nœud local correspond exactement à la version la plus basse de l’autre nœud.

Pour plus d’informations sur la façon dont le service de cluster crée et utilise les numéros de version, consultez Compatibilité des versions.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008 Entreprise, Windows Server 2008 Datacenter
En-tête	clusapi.h

Voir aussi

GetClusterInformation

Partager via