CLUSCTL_RESOURCE_TYPE_NETNAME_GET_OU_FOR_VCO control code
TBD. Applications use this control code as a parameter to ClusterResourceTypeControl function, and resource DLLs receive the control code as a parameter to the ResourceTypeControl callback function.
ClusterResourceTypeControl( hCluster, // cluster handle
lpszResourceTypeName, // resource type name
hHostNode, // optional host node
CLUSCTL_RESOURCE_TYPE_NETNAME_GET_OU_FOR_VCO, // this control code
lpInBuffer, // input buffer
nInBufferSize, // input buffer size
lpOutBuffer, // output buffer
nOutBufferSize, // allocated buffer size
lpBytesReturned ); // actual size of resulting data
Parameters
The following control code function and DLL support parameter is specific to this control code. For complete parameter descriptions, see ClusterResourceTypeControl or ResourceTypeControl.
-
hCluster [in]
-
A handle to the cluster that contains the resource type identified by the lpszResourceTypeName parameter.
-
lpszResourceTypeName [in]
-
A handle to the cluster that contains the resource type identified by the lpszResourceTypeName parameter.
-
hHostNode [in, optional]
-
A handle to the node that hosts the affected resource type.
-
lpInBuffer [in, optional]
-
A pointer to the input buffer that contains the data for the operation, or NULL if no information is needed.
-
nInBufferSize [in]
-
The allocated size of of the lpInBuffer parameter, in bytes.
-
lpOutBuffer [out]
-
A pointer to the output buffer that receives the data retrieved by the operation, or NULL if no data will is retrieved.
-
nOutBufferSize [in]
-
The allocated size of of the lpOutBuffer parameter, in bytes.
-
lpBytesReturned [out, optional]
-
The actual size of the data retrieved by the operation, in bytes.
Return value
When an application uses CLUSCTL_RESOURCE_TYPE_NETNAME_GET_OU_FOR_VC as a parameter for ClusterResourceTypeControl, ClusterResourceTypeControl returns one of the following values:
-
ERROR_SUCCESS
-
0
The operation completed successfully. This value is returned if the lpBytesReturned parameter points to the actual size of the returned data.
-
ERROR_MORE_DATA
-
234 (0xEA)
More data is available. This value is returned if the buffer for lpOutBuffer was not large enough to hold the data that was returned by the operation.
-
The operation was not successful. If the operation required an output buffer, the value specified by lpBytesReturned (if not NULL on input) is unreliable.
Remarks
ClusAPI.h defines the 32 bits of CLUSCTL_RESOURCE_TYPE_NETNAME_GET_OU_FOR_VCO (0x0240026E) as follows:
| Component | Bit location | Value |
|---|---|---|
| Object code |
24 31 |
CLUS_OBJECT_RESOURCE_TYPE (0x2) |
| 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_NETNAME_GET_OU_FOR_VCO (0x40026E) |
| 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 Enterprise, Windows Server 2008 Datacenter |
| Header |
|