3.1.4.2.97 ApiNodeNetInterfaceControl (Opnum 97)

  • Article

(Protocol Version 3) The ApiNodeNetInterfaceControl method instructs the server to initiate, on the specified cluster network interface, 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 that of the ApiNetInterfaceControl method. All return values are identical to those specified in ApiNetInterfaceControl. 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 ApiNodeNetInterfaceControl(
   [in] HNETINTERFACE_RPC hNetInterface,
   [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.