CLUSTERVERSIONINFO-Struktur (clusapi.h)

Artikel
02/26/2024

Beschreibt Informationen zur Lokal auf einem Knoten installierten Version des Clusterdiensts.

Syntax

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;

Member

dwVersionInfoSize

Größe der Datenstruktur in Byte. Benutzer müssen diese Größe festlegen, bevor GetClusterInformation aufgerufen wird.

MajorVersion

Gibt die Hauptversionsnummer des Betriebssystems an, das auf dem lokalen Knoten installiert ist. Für Version X.Y ist z. B. die Hauptversionsnummer X.

MinorVersion

Gibt die Nebenversionsnummer des Betriebssystems an, das auf dem lokalen Knoten installiert ist. Für Version X.Y ist z. B. die Nebenversionsnummer Y.

BuildNumber

Gibt die Buildnummer des Betriebssystems an, das auf dem lokalen Knoten installiert ist, z. B. 224.

szVendorId[64]

Enthält die Anbieterbezeichnerinformationen für den Clusterdienst, der auf dem lokalen Knoten installiert ist.

szCSDVersion[64]

Enthält das neueste Service Pack, das auf dem Knoten installiert ist. Wenn kein Service Pack installiert wurde, ist der szCSDVersion-Member leer.

dwClusterHighestVersion

Gibt die höchste Version des Clusterdiensts an, mit der der auf dem lokalen Knoten installierte Clusterdienst verknüpft werden kann, um einen Cluster zu bilden.

dwClusterLowestVersion

Gibt die niedrigste Version des Clusterdiensts an, mit der der auf dem lokalen Knoten installierte Clusterdienst verknüpft werden kann, um einen Cluster zu bilden.

dwFlags

Wenn auf den Clusterknoten unterschiedliche Versionen des Clusterdiensts ausgeführt werden, wird dieser Wert auf CLUSTER_VERSION_FLAG_MIXED_MODE festgelegt. Wenn auf allen Clusterknoten dieselbe Version des Clusterdiensts ausgeführt wird, ist dieser Wert 0.

dwReserved

Dieser Wert ist für die interne Verwendung reserviert.

Hinweise

Zum Abrufen von Clusterversionsinformationen deklarieren Anwendungen eine CLUSTERVERSIONINFO-Struktur , geben die Größe der Struktur im dwVersionInfoSize-Member an und rufen die GetClusterInformation-Funktion auf. GetClusterInformation füllt die Strukturmemberdaten aus.

Um Überschreibungen für alle möglichen Kombinationen von Versionsinformationen zu verhindern, legen Sie dwVersionInfoSize immer auf fest:

sizeof(CLUSTERVERSIONINFO)

Die Werte dwClusterHighestVersion und dwClusterLowestVersion geben an, ob der lokale Knoten mit einem anderen Knoten verknüpft werden kann, um einen Cluster zu bilden. Ein Join kann erfolgreich sein, wenn einer der folgenden Punkte zutrifft:

Die höchste Version des lokalen Knotens entspricht genau der höchsten Version des anderen Knotens.
Die niedrigste Version des lokalen Knotens entspricht genau der höchsten Version des anderen Knotens.
Die höchste Version des lokalen Knotens entspricht genau der niedrigsten Version des anderen Knotens.

Weitere Informationen dazu, wie der Clusterdienst Versionsnummern erstellt und verwendet, finden Sie unter Versionskompatibilität.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Kopfzeile	clusapi.h

Weitere Informationen

GetClusterInformation

Freigeben über