VMS Help DCE_RPC, Application Routines, rpc_mgmt_ep_elt_inq_next  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME

   rpc_mgmt_ep_elt_inq_next - Returns one element from an endpoint map

   Used by management applications.

 SYNOPSIS

   #include <dce/rpc.h>

   void rpc_mgmt_ep_elt_inq_next( rpc_ep_inq_handle_t inquiry_context,
                                  rpc_if_id_t *if_id,
                                  rpc_binding_handle_t *binding,
                                  uuid_t *object_uuid,
                                  unsigned_char_t **annotation,
                                  unsigned32 *status );

 PARAMETERS

   Input

   inquiry_context
       Specifies an inquiry context.  This inquiry context is returned
       from the rpc_mgmt_ep_elt_inq_begin() routine.

   Output

   if_id
       Returns the interface identifier of the local endpoint map element.

   binding
       Returns the binding handle from the local endpoint map element.
       Specify NULL to prevent the routine from returning this parameter.
       In this case the application does not call the rpc_binding_free()
       routine.

   object_uuid
       Returns the object UUID from the local endpoint map element.
       Specify NULL to prevent the routine from returning this parameter.

   annotation
       Returns the annotation string for the local endpoint map element.
       If there is no annotation string in the local endpoint map element,
       the string \0 is returned.
       Specify NULL to prevent the routine from returning this argument.
       In this case the application does not call the rpc_string_free()
       routine.

   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.

       ept_s_cant_perform_op
                     Cannot perform the requested operation.

       rpc_s_comm_failure
                     Communications failure.

       ept_s_database_invalid
                     Endpoint map database invalid.

       rpc_s_fault_context_mismatch
                     Fault context mismatch.

       ept_s_invalid_context
                     Invalid inquiry type for this context.

       ept_s_invalid_entry
                     Invalid database entry.

       rpc_s_invalid_arg
                     Invalid argument.

       rpc_s_invalid_inquiry_context
                     Invalid inquiry context.

       rpc_s_invalid_inquiry_type
                     Invalid inquiry type.

       rpc_s_no_more_elements
                     No more elements.

 DESCRIPTION

   The rpc_mgmt_ep_elt_inq_next() routine returns one element from the
   local endpoint map.  Regardless of the selector value specified for
   the inquiry_type parameter in rpc_mgmt_ep_elt_inq_begin(), this
   routine returns all the components of a selected local endpoint map
   element.  The rpc_ep_register() routine's reference page summarizes
   the contents of an element in the local endpoint map.

   An application can view all the selected local endpoint map elements
   by repeatedly calling the rpc_mgmt_ep_elt_inq_next() routine.  When
   all the elements have been viewed, this routine returns an
   rpc_s_no_more_elements status.  The returned elements are unordered.

   If a remote endpoint map contains elements that include a protocol
   sequence that your system does not support, this routine does not
   return the elements.  (A protocol sequence is part of the binding
   information component of an endpoint map element.)  To receive all
   possible elements from a remote endpoint map, your application must
   run on a system that supports the protocol sequences included in
   the elements.

   For example, if your system does not support protocol sequence
   ncacn_ip_tcp and a remote endpoint map contains elements that
   include this protocol sequence, this routine does not return these
   elements to your application.  If your application ran on a system
   that supported protocol sequence ncacn_ip_tcp, this routine would
   return the elements.

   The RPC runtime allocates memory for the returned binding and the
   annotation string on each call to this routine.  The application
   calls the rpc_binding_free() routine for each returned binding and
   the rpc_string_free() routine for each returned annotation string.

   After viewing the local endpoint map's elements, the application must
   call the rpc_mgmt_ep_elt_inq_done() routine to delete the inquiry
   context.

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_binding_free
              rpc_ep_register
              rpc_ep_register_no_replace
              rpc_mgmt_ep_elt_begin
              rpc_mgmt_ep_elt_done
              rpc_string_free