Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

3.1.5.13.1 SamrCloseHandle (Opnum 1)

The SamrCloseHandle method closes (that is, releases server-side resources used by) any context handle obtained from this RPC interface.

 long SamrCloseHandle(
   [in, out] SAMPR_HANDLE* SamHandle
 );

SamHandle: An RPC context handle, as specified in section 2.2.3.2, representing any context handle returned from this interface.

This protocol asks the RPC runtime, via the strict_context_handle attribute, to reject the use of context handles created by a method of a different RPC interface than this one, as specified in [MS-RPCE] section 3.

Upon receiving this message, the server MUST process the data from the message subject to the following constraints:

  1. If SamHandle is 0, the server MUST return an error.

  2. Otherwise, the server MUST delete the SamContextHandle (section 3.1.1.10) represented by SamHandle, and then MUST return 0 for the value of SamHandle and a return code of STATUS_SUCCESS.

Show:
© 2015 Microsoft