rpc_ns_binding_import_done(3) — Subroutines

NAME

rpc_ns_binding_import_done - 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_contextSpecifies the name service handle to delete. (A name service handle is created by calling the rpc_ns_binding_import_begin routine.) 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. The possible status codes and their meanings are as follows:

rpc_s_okSuccess.

rpc_s_invalid_ns_handleInvalid name service handle.

DESCRIPTION

The rpc_ns_binding_import_done routine deletes an import context created by calling the rpc_ns_binding_import_begin routine. 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 the rpc_ns_binding_import_next routine. A client program calls this routine for each created import context, regardless of the status returned from the rpc_ns_binding_import_next routine, or the success in making remote procedure calls.

Permissions Required

None.

NOTE:

For this release, the RPC naming service (rpc_ns) routines are not implemented, nor is an independent naming service provided.

RETURN VALUES