Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 | 
 |