NAME

rpc_mgmt_ep_elt_inq_next - Returns one element from a local or remote 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_contextSpecifies an inquiry context.  This inquiry context is returned from the rpc_mgmt_ep_elt_inq_begin routine. 

Output

if_idReturns the interface identifier of the local endpoint map element. 

bindingReturns the binding handle from the local endpoint map element.  Specify NULL to prevent the routine from returning this argument.  In this case the application does not call the rpc_binding_free routine. 

object_uuidReturns the object UUID from the local endpoint map element.  Specify NULL to prevent the routine from returning this argument. 

annotationReturns 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. 

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. 

ept_s_cant_perform_opCannot perform requested operation. 

rpc_s_comm_failureCommunications failure. 

ept_s_database_invalidEndpoint map database invalid. 

rpc_s_fault_context_mismatch
Fault context mismatch.

ept_s_invalid_contextInvalid inquiry type for this context. 

ept_s_invalid_entryInvalid database entry. 

rpc_s_invalid_argInvalid argument. 

rpc_s_invalid_inquiry_context
Invalid inquiry context.

rpc_s_invalid_inquiry_typeInvalid inquiry type. 

rpc_s_no_more_elementsNo 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 argument in rpc_mgmt_ep_elt_inq_begin, this routine returns all the components of a selected local endpoint map element.  The description of the rpc_ep_register routine 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. 

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

None. 

RELATED INFORMATION

Functions: rpc_binding_free(3), rpc_ep_register(3), rpc_ep_register_no_replace(3), rpc_mgmt_ep_elt_begin(3), rpc_mgmt_ep_elt_done(3), rpc_string_free(3)