Skip to content

Latest commit

 

History

History
137 lines (104 loc) · 5.31 KB

ns-clusapi-clusterversioninfo.md

File metadata and controls

137 lines (104 loc) · 5.31 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NS:clusapi.CLUSTERVERSIONINFO
CLUSTERVERSIONINFO (clusapi.h)
Describes information about the version of the Cluster service installed locally on a node.
*LPCLUSTERVERSIONINFO
*PCLUSTERVERSIONINFO
CLUSTERVERSIONINFO
CLUSTERVERSIONINFO structure [Failover Cluster]
LPCLUSTERVERSIONINFO
LPCLUSTERVERSIONINFO structure pointer [Failover Cluster]
PCLUSTERVERSIONINFO
PCLUSTERVERSIONINFO structure pointer [Failover Cluster]
_wolf_clusterversioninfo
clusapi/CLUSTERVERSIONINFO
clusapi/LPCLUSTERVERSIONINFO
clusapi/PCLUSTERVERSIONINFO
mscs.clusterversioninfo
mscs\clusterversioninfo.htm
MsCS
e1cecdbc-f0e4-4ee8-9a97-14859ceba5fd
12/05/2018
*LPCLUSTERVERSIONINFO, *PCLUSTERVERSIONINFO, CLUSTERVERSIONINFO, CLUSTERVERSIONINFO structure [Failover Cluster], LPCLUSTERVERSIONINFO, LPCLUSTERVERSIONINFO structure pointer [Failover Cluster], PCLUSTERVERSIONINFO, PCLUSTERVERSIONINFO structure pointer [Failover Cluster], _wolf_clusterversioninfo, clusapi/CLUSTERVERSIONINFO, clusapi/LPCLUSTERVERSIONINFO, clusapi/PCLUSTERVERSIONINFO, mscs.clusterversioninfo
clusapi.h
Windows
None supported
Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Windows
CLUSTERVERSIONINFO, *LPCLUSTERVERSIONINFO, *PCLUSTERVERSIONINFO
19H1
CLUSTERVERSIONINFO
clusapi/CLUSTERVERSIONINFO
LPCLUSTERVERSIONINFO
clusapi/LPCLUSTERVERSIONINFO
c++
APIRef
kbSyntax
HeaderDef
ClusAPI.h
CLUSTERVERSIONINFO

CLUSTERVERSIONINFO structure

-description

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

-struct-fields

-field dwVersionInfoSize

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

-field 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.

-field 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.

-field BuildNumber

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

-field szVendorId

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

-field szCSDVersion

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

-field 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.

-field 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.

-field 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.

-field 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.

-see-also

GetClusterInformation