3.1.4.2.77 ApiNodeGroupControl (Opnum 76)

  • Article

(Protocol Version 3) The ApiNodeGroupControl method instructs the server to initiate, on the specified group, 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 ApiGroupControl method. In addition, the server MUST require that the access level associated with the hNode context handle is "All" (section 3.1.4), if and only if the bitwise AND of dwControlCode and 0x00400000 is not equal to zero.

 error_status_t ApiNodeGroupControl(
   [in] HGROUP_RPC hGroup,
   [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] DWORD nOutBufferSize,
   [out] DWORD *lpBytesReturned,
   [out] DWORD *lpcbRequired,
   [out] error_status_t *rpc_status
 );

hNode: An HNODE_RPC context handle that is obtained in a previous ApiOpenNode or ApiOpenNodeEx method call.