NAME

rpc_mgmt_ep_elt_inq_next- returns one element from an endpoint map

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 endpoint map element.

binding

Returns the binding handle from the endpoint map element.

Specify NULL to prevent the routine from returning this argument.

object_uuid

Returns the object UUID from the endpoint map element.

Specify NULL to prevent the routine from returning this argument.

annotation

Returns the annotation string for the endpoint map element. When there is no annotation string in the endpoint map element, the empty string ("") is returned.

Specify NULL to prevent the routine from returning this argument.

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.

ept_s_cant_perform_op

Cannot perform the requested operation.

rpc_s_no_more_elements

No more elements.

rpc_s_com_failure

Communications failure.

DESCRIPTION

The rpc_mgmt_ep_elt_inq_next() routine returns one element from the endpoint map. Elements selected depend on the inquiry context. The selection criteria are determined by the inquiry_type argument of the rpc_mgmt_ep_elt_inq_begin() call that returned inquiry_context. tagmref_rpc_mgmt_ep_elt_inq_begin describes inquiry types.

An application can view all the selected 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.

When the respective arguments are non-NULL, the RPC run-time system allocates memory for the returned binding and the annotation string on each call to this routine. The application is responsible for calling the rpc_binding_free() routine for each returned binding and the rpc_string_free() routine for each returned annotation string.

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

RETURN VALUE

None.

SEE ALSO

rpc_binding_free()
rpc_ep_register()
rpc_ep_register_no_replace()
rpc_mgmt_ep_elt_inq_begin()
rpc_mgmt_ep_elt_inq_done()
rpc_string_free().

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.