Edit

Share via

CLUSTERVERSIONINFO structure (clusapi.h)

  • Article

Describes information about the version of the Cluster service installed locally on a node.

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;

Members

dwVersionInfoSize

Size, in bytes, of the data structure. Users must set this size prior to calling GetClusterInformation.

MajorVersion

Identifies the major version number of the operating system installed on the local node. For example, for version X.Y, the major version number is X.

MinorVersion

Identifies the minor version number of the operating system installed on the local node. For example, for version X.Y, the minor version number is Y.

BuildNumber

Identifies the build number of the operating system installed on the local node, such as 224.

szVendorId[64]

Contains the vendor identifier information for the Cluster service installed on the local node.

szCSDVersion[64]

Contains the latest service pack installed on the node. If a Service Pack has not been installed, the szCSDVersion member is empty.

dwClusterHighestVersion

Identifies the highest version of the Cluster service with which the Cluster service installed on the local node can join to form a cluster.

dwClusterLowestVersion

Identifies the lowest version of the Cluster service with which the Cluster service installed on the local node can join to form a cluster.

dwFlags

If the cluster nodes are running different versions of the Cluster service, this value is set to CLUSTER_VERSION_FLAG_MIXED_MODE. If all cluster nodes are running the same version of the Cluster service, this value is 0.

dwReserved

This value is reserved for internal use.

Remarks

To obtain cluster version information, applications declare a CLUSTERVERSIONINFO structure, specify the size of the structure in the dwVersionInfoSize member, and call the GetClusterInformation function. GetClusterInformation fills in the structure member data.

To prevent overwrites for all possible combinations of version information, always set dwVersionInfoSize to:

sizeof(CLUSTERVERSIONINFO)

The dwClusterHighestVersion and dwClusterLowestVersion values indicate whether the local node can join with another node to form a cluster. A join can succeed if one of the following is true:

  • The local node's highest version exactly matches the other node's highest version.
  • The local node's lowest version exactly matches the other node's highest version.
  • The local node's highest version exactly matches the other node's lowest version.
For more information on how the Cluster service creates and uses version numbers, see Version Compatibility.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Header clusapi.h

See also

GetClusterInformation