PreviousNext

rpc_ns_binding_import_done(3rpc)

Deletes the import context for searching the name service database

Used by client applications.

Synopsis

#include <dce/rpc.h>

void rpc_ns_binding_import_done(

rpc_ns_handle_t *import_context,

unsigned32 *status);

Parameters

Input/Output

import_context
Specifies the name service handle to delete. (A name service handle is created by calling rpc_ns_binding_import_begin( ).)

Returns the value NULL.

Output

status
Returns the status code from this routine. This status code indicates whether the routine completed successfully or, if not, why not.

Description
The rpc_ns_binding_import_done( ) routine deletes an import context created by calling rpc_ns_binding_import_begin( ). This deletion does not affect any previously imported bindings.

Typically, a client calls this routine after completing remote procedure calls to a server using a binding handle returned from rpc_ns_binding_import_next( ). A client program calls this routine for each created import context, regardless of the status returned from rpc_ns_binding_import_next( ), or the success in making remote procedure calls.

Permissions Required
No permissions are required.

Return Values
No value is returned.

Errors

The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

rpc_s_ok
Success.

rpc_s_invalid_ns_handle
Invalid name service handle.

Related Information
Functions: rpc_ns_binding_import_begin(3rpc)

rpc_ns_binding_import_next(3rpc)