CLUSCTL_GROUP_GET_PRIVATE_PROPERTY_FMTS control code

The CLUSCTL_NETINTERFACE_GET_PRIVATE_PROPERTY_FMTS control code is not supported and fails with ERROR_INVALID_FUNCTION.


ClusterGroupControl( hCluster,                                 // cluster handle
                     hHostNode,                                // optional node handle
                     CLUSCTL_GROUP_GET_PRIVATE_PROPERTY_FMTS,  // this control code
                     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

The following control code function parameter is specific to this control code. For complete parameter descriptions, see ClusterGroupControl.

Return value

ClusterGroupControl returns ERROR_INVALID_FUNCTION.

ERROR_INVALID_FUNCTION

1

Incorrect function. The CLUSCTL_NETINTERFACE_GET_PRIVATE_PROPERTY_FMTS control code is not supported.

Remarks

By default, failover clusters do not define any private properties for groups. CLUSCTL_GROUP_GET_PRIVATE_PROPERTY_FMTS does not retrieve information about unknown properties.

ClusAPI.h defines the 32 bits of CLUSCTL_GROUP_GET_PRIVATE_PROPERTY_FMTS as follows.

ComponentBit locationValue

Object code

24–31

CLUS_OBJECT_GROUP (0x3)

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)

 

For more information, see Control Code Architecture.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 Datacenter, Windows Server 2008 Enterprise

Header

ClusAPI.h

See also

Group Control Codes
ClusterGroupControl

 

 

Show: