Share via

3.1.4.2.155 ApiNodeGroupSetControl (Opnum 173)

  • Article

The ApiNodeGroupSetControl method<142> provides arbitrary communication and control between an application and an instance of a group set. This method instructs the server to initiate, on the specified group set, an operation that is defined by the specified control code. If necessary, the operation is forwarded to and executed on the specified node.

The semantic behavior, as well as all parameters with the exception of hNode, are identical to the ApiGroupSetControl (section 3.1.4.2.156) method. In addition, the server MUST require that the access level associated with the hGroupSet context handle is "All" (section 3.1.4), if and only if the bitwise AND of dwControlCode and 0x00400000 is not equal to zero. The server MUST require that the access level associated with the hNode context handle is the same as the access level required for the control code identified by dwControlCode.

 error_status_t
 ApiNodeGroupSetControl (
   [ in ] HGROUPSET_RPC hGroupSet,
   [ in ] HNODE_RPC hNode,
   [ in ] DWORD dwControlCode,
   [ in, unique, size_is(nInBufferSize) ] UCHAR *lpInBuffer,
   [ in ] DWORD nInBufferSize,
   [ out, size_is(nOutBufferSize), length_is(*lpBytesReturned) ] UCHAR *lpOutBuffer,
   [ in, range(0, MAX_CLUSTER_CONTROL_CODE_BUFFER_SIZE) ] DWORD nOutBufferSize,
   [ out ] DWORD *lpBytesReturned,
   [ out ] DWORD *lpcbRequired,
   [ out ] error_status_t *rpc_status
 );

hNode: An HNODE_RPC (section 2.2.1.2) context handle that is obtained in a previous ApiOpenNode (section 3.1.4.2.67) or ApiOpenNodeEx (section 3.1.4.2.117) method call. hNode represents a handle to the node on which the control should be delivered. If this is NULL, the node where the application is bound performs the request.