3.1.4.3 S_DSCloseServerHandle (Opnum 23)

This method closes the RPC context handle returned by a previous call to S_DSValidateServer. The server releases resources associated with the RPC context handle.

 HRESULT S_DSCloseServerHandle(
   [in, out] PPCONTEXT_HANDLE_SERVER_AUTH_TYPE pphServerAuth
 );

pphServerAuth:  The PCONTEXT_HANDLE_SERVER_AUTH_TYPE RPC context handle to close. It MUST have been acquired from the pphServerAuth parameter in a previous call to S_DSValidateServer, and MUST NOT have been closed through a previous call to S_DSCloseServerHandle. The server MUST set this parameter to NULL.

Return Values:  If the method succeeds, the return value is 0. If the method fails, the return value is an implementation-specific error code.

MQ_OK (0x00000000)

Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol as specified in [MS-RPCE].

The server MUST use the pphServerAuth parameter as a key into the security context table. The server MUST delete the GSS security context associated with the security context entry through a call to GSS_Delete_sec_context, as specified in [RFC2743] section 2.2.3. The server MUST remove the security context entry from the security context table.

On return from this call, the client SHOULD delete the GSS security context associated with dwContext through a call to GSS_Delete_sec_context, as specified in [RFC2743] section 2.2.3.