rpc_ns_binding_lookup_done(3) — Subroutines

NAME

rpc_ns_binding_lookup_done - Deletes the lookup context for searching the name service database

Used by client applications.

SYNOPSIS

#include <dce/rpc.h>
void rpc_ns_binding_lookup_done(

rpc_ns_handle_t ∗lookup_context ,
unsigned32 ∗status );

PARAMETERS

Input/Output

lookup_contextSpecifies the name service handle to delete. (A name service handle is created by calling the rpc_ns_binding_lookup_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_lookup_done routine deletes a lookup context created by calling the rpc_ns_binding_lookup_begin routine.

Typically, a client calls this routine after completing remote procedure calls to a server using a binding handle returned from the rpc_ns_binding_lookup_next routine. A client program calls this routine for each created lookup context, regardless of the status returned from the rpc_ns_binding_lookup_next routine, or 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