NAME

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

SYNOPSIS

#include <dce/rpc.h>

void rpc_ns_binding_lookup_done(
	rpc_ns_handle_t *lookup_context,
	unsigned32 *status);

PARAMETERS

Input/Output

lookup_context

Specifies the name service handle to delete. (A name service handle is created by calling the rpc_ns_binding_lookup_begin() routine.)

On success, returns the value NULL.

Output

status

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

Possible status codes and their meanings include:

rpc_s_ok

Success.

DESCRIPTION

The rpc_ns_binding_lookup_done() routine deletes a lookup context created by calling the rpc_ns_binding_lookup_begin() routine.

Note:

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.

RETURN VALUE

None.

SEE ALSO

rpc_ns_binding_lookup_begin()
rpc_ns_binding_lookup_next().

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.