3.1.4.19 S_DSLookupEnd (Opnum 8)

  • Article

This method closes an opened RPC context handle created from a previous call to S_DSLookupBegin (section 3.1.4.17).

 HRESULT S_DSLookupEnd(
   [in] handle_t hBind,
   [in, out] PPCONTEXT_HANDLE_TYPE phContext
 );

hBind:  MUST specify an RPC binding handle, as specified in [MS-RPCE] section 2.

phContext:  MUST point to an RPC context handle returned by a previous call to S_DSLookupBegin. MUST NOT have been used in a previous call to S_DSLookupEnd (section 3.1.4.19). 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 extension protocol, as specified in [MS-RPCE].

When processing this call, the server MUST:

  • Generate an End Directory Lookup (section 3.1.6.9) event with the following argument:

    • iLookupDescriptor := the object referenced by the phContext parameter

  • Set phContext to NULL.

  • Return rStatus of the preceding event.