Share via

3.1.4.2.79 ApiNodeNodeControl (Opnum 78)

  • Article

(Protocol Version 3) The ApiNodeNodeControl method instructs the server to initiate, on the node designated by hNode, an operation that is defined by the specified control code. The operation is forwarded to and executed on the node designated by hHostNode. The hNode parameter MUST NOT be set to the calling node.

The semantic behavior and all parameters, with the exception of hHostNode, are identical to the ApiNodeControl method. In addition, the server MUST require that the access level associated with the hHostNode 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 ApiNodeNodeControl(
   [in] HNODE_RPC hNode,
   [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.