CLUSCTL_NETINTERFACE_VALIDATE_COMMON_PROPERTIES control code

Verifies that a property list contains valid network interface property names and values and that the list is properly formatted. Applications use this control code as a ClusterNetInterfaceControl parameter.

ClusterNetInterfaceControl( hNetInterface,  // network interface handle
                            hHostNode,      // optional host node
                            CLUSCTL_NETINTERFACE_VALIDATE_COMMON_PROPERTIES, // control code
                            lpInBuffer,     // input buffer: property list
                            cbInBufferSize, // allocated buffer size (bytes)
                            NULL,           // output buffer (not used)
                            0,              // output buffer size (not used)
                            NULL );         // size of output (not used)

Parameters

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

lpInBuffer

Pass a pointer to a property list containing one or more read/write network interface common properties.

Return value

ClusterNetInterfaceControl returns one of the following values.

ERROR_SUCCESS

0

The operation completed successfully. The property list is correctly formatted and contains valid data values.

ERROR_INSUFFICIENT_BUFFER

122 (0x7A)

The data area passed to a system call is too small. The actual size of the property list buffer as determined by the Cluster service is larger than the size specified in the cbInBufferSize parameter.

ERROR_INVALID_DATA

13 (0xD)

The data is invalid. The property list is either formatted incorrectly or contains invalid data, such as an out-of-range value.

ERROR_INVALID_PARAMETER

87 (0x57)

The parameter is incorrect.

RPC_X_BAD_STUB_DATA

1783 (0x6F7)

The stub received bad data. The lpInBuffer parameter is NULL.

System error code

If any other value is returned, then the operation failed.

Remarks

The CLUSCTL_NETINTERFACE_VALIDATE_COMMON_PROPERTIES control code validates only read/write network interface common properties. Property lists containing private or read-only properties cause validation to fail. For information on working with property lists, see Using Property Lists.

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

Component Bit location Value
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_VALIDATE_COMMON_PROPERTIES (0x61)
Access code
0 1
CLUS_ACCESS_READ (0x1)

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Header
ClusAPI.h

See also

Network Interface Control Codes

ClusterNetInterfaceControl