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.
-
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 |
|