Struttura CLUSTERVERSIONINFO (clusapi.h)

Articolo
02/24/2024

Vengono descritte le informazioni sulla versione del servizio cluster installata localmente in un nodo.

Sintassi

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;

Members

dwVersionInfoSize

Dimensioni, in byte, della struttura dei dati. Gli utenti devono impostare questa dimensione prima di chiamare GetClusterInformation.

MajorVersion

Identifica il numero di versione principale del sistema operativo installato nel nodo locale. Ad esempio, per la versione X.Y, il numero di versione principale è X.

MinorVersion

Identifica il numero di versione secondaria del sistema operativo installato nel nodo locale. Ad esempio, per la versione X.Y, il numero di versione secondaria è Y.

BuildNumber

Identifica il numero di build del sistema operativo installato nel nodo locale, ad esempio 224.

szVendorId[64]

Contiene le informazioni sull'identificatore del fornitore per il servizio Cluster installato nel nodo locale.

szCSDVersion[64]

Contiene il Service Pack più recente installato nel nodo. Se un Service Pack non è stato installato, il membro szCSDVersion è vuoto.

dwClusterHighestVersion

Identifica la versione più recente del servizio Cluster con cui il servizio Cluster installato nel nodo locale può essere aggiunto per formare un cluster.

dwClusterLowestVersion

Identifica la versione più bassa del servizio Cluster con cui il servizio Cluster installato nel nodo locale può essere aggiunto per formare un cluster.

dwFlags

Se i nodi del cluster eseguono versioni diverse del servizio cluster, questo valore viene impostato su CLUSTER_VERSION_FLAG_MIXED_MODE. Se tutti i nodi del cluster eseguono la stessa versione del servizio Cluster, questo valore è 0.

dwReserved

Questo valore è riservato per l'uso interno.

Commenti

Per ottenere informazioni sulla versione del cluster, le applicazioni dichiarano una struttura CLUSTERVERSIONINFO , specificare le dimensioni della struttura nel membro dwVersionInfoSize e chiamare la funzione GetClusterInformation . GetClusterInformation compila i dati dei membri della struttura.

Per evitare sovrascrizioni per tutte le possibili combinazioni di informazioni sulla versione, impostare sempre dwVersionInfoSize su:

sizeof(CLUSTERVERSIONINFO)

I valori dwClusterHighestVersion e dwClusterLowestVersion indicano se il nodo locale può essere aggiunto a un altro nodo per formare un cluster. Un join può avere esito positivo se una delle condizioni seguenti è vera:

La versione più recente del nodo locale corrisponde esattamente alla versione più recente dell'altro nodo.
La versione più bassa del nodo locale corrisponde esattamente alla versione più recente dell'altro nodo.
La versione più recente del nodo locale corrisponde esattamente alla versione più bassa dell'altro nodo.

Per altre informazioni su come il servizio cluster crea e usa i numeri di versione, vedere Compatibilità delle versioni.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Intestazione	clusapi.h

Vedi anche

GetClusterInformation

Condividi tramite