3.1.4.2.73 ApiNodeResourceControl (Opnum 72)

  • Article

(Protocol Version 3) The ApiNodeResourceControl method instructs the server to initiate, on the specified resource, 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 ApiResourceControl method, as specified in section 3.1.4.2.74. 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, except as otherwise specified for particular control codes in section 3.1.4.2.74.

 error_status_t ApiNodeResourceControl(
   [in] HRES_RPC hResource,
   [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.