CLUSCTL_NETWORK_GET_PRIVATE_PROPERTY_FMTS control code

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

ClusterNetworkControl( hCluster,                               // cluster handle
                       hHostNode,                              // optional node handle
                       CLUSCTL_NETWORK_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 ClusterNetworkControl.

Return value

ClusterNetworkControl returns ERROR_INVALID_FUNCTION.

ERROR_INVALID_FUNCTION

1

Incorrect function. The CLUSCTL_NETWORK_GET_PRIVATE_PROPERTY_FMTS control code is not supported.

Remarks

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

ClusAPI.h defines the 32 bits of CLUSCTL_NETWORK_GET_PRIVATE_PROPERTY_FMTS as follows (for more information, see Control Code Architecture).

Component Bit location Value
Object code
24 31
CLUS_OBJECT_NETWORK (0x5)
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
ClusAPI.h

See also

Network Control Codes

ClusterNetworkControl