CLUSCTL_NODE_GET_PRIVATE_PROPERTY_FMTS control code
The CLUSCTL_NODE_GET_PRIVATE_PROPERTY_FMTS control code is not supported and fails with ERROR_INVALID_FUNCTION.
ClusterNodeControl( hCluster, // cluster handle
hHostNode, // optional node handle
CLUSCTL_NODE_GET_PRIVATE_PROPERTY_FMTS,
NULL, // input buffer (not used)
0, // input buffer size (not used)
NULL, // output buffer: (not used)
0, // output buffer size (not used)
lpcbBytesReturned ); // resulting data size (bytes)
Parameters
For complete parameter descriptions, see ClusterNodeControl.
Return value
ClusterNodeControl returns ERROR_INVALID_FUNCTION.
-
ERROR_INVALID_FUNCTION
-
1
Incorrect function. The CLUSCTL_NODE_GET_PRIVATE_PROPERTY_FMTS control code is not supported.
Remarks
By default, failover clusters do not define any private properties for nodes. CLUSCTL_NODE_GET_PRIVATE_PROPERTY_FMTS does not retrieve information about unknown properties.
ClusAPI.h defines the 32 bits of CLUSCTL_NODE_GET_PRIVATE_PROPERTY_FMTS as follows (for more information, see Control Code Architecture).
| Component | Bit location | Value |
|---|---|---|
| Object code |
24 31 |
CLUS_OBJECT_NODE (0x4) |
| Global bit |
23 |
CLUS_NOT_GLOBAL (0x0) |
| Modify bit |
22 |
CLUS_NO_MODIFY (0x0) |
| User bit |
21 |
CLCTL_CLUSTER_BASE (0x0) |
| Type bit |
20 |
External (0x0) |
| Operation code |
0 23 |
CLCTL_GET_PRIVATE_PROPERTY_FMTS (0x8d) |
| Access code |
0 1 |
CLUS_ACCESS_READ (0x1) |
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2008 Datacenter, Windows Server 2008 Enterprise |
| Header |
|