VMS Help  —  DCE  DCE_RPC, Application Routines, rpc_ns_binding_lookup_done
 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_context
       Specifies the name service handle to delete. (A name service
       handle is created by calling rpc_ns_binding_lookup_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.  The possible status codes and their meanings
       are as follows:

       rpc_s_ok                         Success.

       rpc_s_invalid_ns_handle          Invalid name service handle.

 DESCRIPTION

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

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

   Permissions Required

   No permissions are required.

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_ns_binding_lookup_begin
              rpc_ns_binding_lookup_next
Close Help