3.1.4.33 EvtRpcClose (Opnum 13)

  • Article

The EvtRpcClose (Opnum 13) method is used by a client to close context handles that are opened by other methods in this protocol.

 error_status_t EvtRpcClose(
   [in, out, context_handle] void** handle
 );

handle: This parameter is an RPC context handle, as specified in [C706], Context Handles.

Return Values: The method MUST return ERROR_SUCCESS (0x00000000) on success; otherwise, it MUST return an implementation-specific nonzero value as specified in [MS-ERREF].

In response to this request from the client, the server MUST first validate the handle. The server SHOULD save the handle value in its handle table (as specified in section 3.1.1.12) when the handle is created so that it can look up the handle in its table to determine if it is valid.<66> The server MUST fail the operation with the error ERROR_INVALID_PARAMETER (0x00000057) if the handle is not in its handle table. For more information on handle security and authentication considerations, see sections 2.2.20 and 5.1.

If the above check succeeds, the server MUST remove the handle from its handle table. The server SHOULD NOT fail the operation of removing the handle.

The server MUST return a value indicating success or failure for this operation.