Share via


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

See also

Group Control Codes

ClusterGroupControl