3.1.4.3 I_nsi_lookup_done (Opnum 1)

The I_nsi_lookup_done method is invoked to free any resources associated with the context handle returned by a preceding call to the I_nsi_lookup_begin method. The MIDL syntax of this method is specified as follows.

 void I_nsi_lookup_done(
   [in] handle_t hrpcPrimaryLocatorHndl,
   [in, out] NSI_NS_HANDLE_T* import_context,
   [out] unsigned short* status
 );

hrpcPrimaryLocatorHndl: An RPC server binding handle, as specified in [C706] Part 2, "Binding Handle". A client creates this handle by binding to the locator server using the UUID specified in section 1.9 and endpoint specified in section 2.1. A client can create the binding handle using the rpc_string_binding_compose and rpc_binding_from_string_binding APIs (as specified in [C706] the "rpc_string_binding_compose" section) or equivalent on the client system's implementation of RPC. When all operations using this handle are completed, use the equivalent of rpc_binding_free to free the handle resources.

import_context: A context handle returned by the server from a preceding call to the I_nsi_lookup_begin method. On successful completion, this parameter MUST be set to NULL by the server and MUST NOT be modified on failure.

status: A 16-bit value that indicates the results of the method call. In case of success, the value will contain NSI_S_OK, or a nonzero value on failure. All failures MUST be treated identically as a failure of the freeing process initiated by this method, but no further action is required by the caller.

Return Values: This method does not return any values.

Exceptions Thrown

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