NAME

rpc_ns_binding_import_done — Deletes the import context for searching the name service database;  used by client applications

Synopsis

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

statusReturns 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).