Share via


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.

System error code

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

See also

External Resource Type Control Codes

ClusterResourceTypeControl

ResourceTypeControl