CLUSCTL_NETINTERFACE_GET_PRIVATE_PROPERTY_FMTS control code

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


ClusterNetInterfaceControl( hCluster,                               // cluster handle
                            hHostNode,                              // optional node handle
                            CLUSCTL_NETINTERFACE_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

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

Return value

ClusterNetInterfaceControl returns 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 network interfaces. CLUSCTL_NETINTERFACE_GET_PRIVATE_PROPERTY_FMTS does not retrieve information about unknown properties.

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

ComponentBit locationValue

Object code

24–31

CLUS_OBJECT_NETINTERFACE (0x6)

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 Interface Control Codes
ClusterNetInterfaceControl

 

 

Show: