rpc_mgmt_ep_elt_inq_next(3rpc)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 Output
if_id
binding 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 Specify NULL to prevent the routine from returning this parameter.
annotation Specify NULL to prevent the routine from returning this argument. In this case the application does not call the rpc_string_free( ) routine.
status
Description 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 Errors The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.
rpc_s_ok
ept_s_cant_perform_op
rpc_s_comm_failure
ept_s_database_invalid
rpc_s_fault_context_mismatch
ept_s_invalid_context
ept_s_invalid_entry
rpc_s_invalid_arg
rpc_s_invalid_inquiry_context
rpc_s_invalid_inquiry_type
rpc_s_no_more_elements
Related Information rpc_ep_register_no_replace(3rpc) rpc_mgmt_ep_elt_inq_begin(3rpc) rpc_mgmt_ep_elt_inq_done(3rpc)
|