3.1.4.2.105 ApiNodeClusterControl (Opnum 105)

  • Article

(Protocol Version 3) The ApiNodeClusterControl method instructs the server to initiate, on the specified cluster, 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 the parameters, with the exception of hHostNode, are identical to those of the ApiClusterControl method. All return values are identical to those specified in section 3.1.4.2.106.

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 ApiNodeClusterControl(
   [in] HCLUSTER_RPC hCluster,
   [in] HNODE_RPC hHostNode,
   [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
 );

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