CLUSCTL_GROUP_UNKNOWN control code
This control code verifies that control codes are being processed on the node where execution of the control is directed. Applications use this control code as a ClusterGroupControl parameter.
ClusterGroupControl(
hGroup, // group handle
hHostNode, // optional node handle
CLUSCTL_GROUP_UNKNOWN, // this control code
NULL, // input buffer (not used)
0, // input buffer size (not used)
NULL, // output buffer (not used)
0, // output buffer size (not used)
NULL // resulting data size (not used)
);
Parameters
For complete parameter descriptions, see ClusterGroupControl. This control code has no parameters associated with it.
Return value
When an application uses CLUSCTL_GROUP_UNKNOWN as a parameter for ClusterGroupControl, ClusterGroupControl always returns ERROR_SUCCESS.
Remarks
Do not use any group control codes in any resource DLL entry point function. Group control codes can safely be called from a worker thread. For more information, see Function Calls to Avoid in Resource DLLs.
ClusAPI.h defines the 32 bits of CLUSCTL_GROUP_UNKNOWN as follows (for more information, see Control Code Architecture).
Component | Bit location | Value |
---|---|---|
Object code | 24 31 | CLUS_OBJECT_GROUP (0x3) |
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_UNKNOWN (0x0) |
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 |
|