NAME

rpc_ns_profile_elt_inq_next- returns one element at a time from a profile

SYNOPSIS

#include <dce/rpc.h>

void rpc_ns_profile_elt_inq_next(
	rpc_ns_handle_t inquiry_context,
	rpc_if_id_t *if_id,
	unsigned_char_t **member_name,
	unsigned32 *priority,
	unsigned_char_t **annotation,
	unsigned32 *status);

PARAMETERS

Input

inquiry_context

Specifies a name service handle. This handle is returned from the rpc_ns_profile_elt_inq_begin() routine.

Output

if_id

Returns the interface identifier of the profile element.

member_name

Returns a pointer to the profile element's member name.

The syntax of the returned name is specified by the member_name_syntax argument in the rpc_ns_profile_elt_inq_begin() routine.

Specifying NULL prevents the routine from returning this argument. In this case the application need not call the rpc_string_free() routine.

priority

Returns the profile element priority.

annotation

Returns the annotation string for the profile element. If there is no annotation string in the profile element, the empty string ("") is returned.

Specifying NULL prevents the routine from returning this argument. In this case the application need not call the rpc_string_free() routine.

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.

rpc_s_entry_not_found

Name service entry not found.

rpc_s_not_rpc_entry

Not an RPC entry.

rpc_s_class_version_mismatch

Name service entry has incompatible RPC class version.

rpc_s_name_service_unavailable

Name service unavailable.

rpc_s_no_more_elements

No more elements.

rpc_s_no_ns_permission

No permission for name service operation.

DESCRIPTION

The rpc_ns_profile_elt_inq_next() routine returns one element from the profile specified by the profile_name argument in the rpc_ns_profile_elt_inq_begin() routine.

The selection criteria for the element returned are based on the inquiry_type argument in routine rpc_ns_profile_elt_inq_begin(). Routine rpc_ns_profile_elt_inq_next() returns all the components (interface identifier, member name, priority, annotation string) of a profile element.

An application can view all the selected profile entries by repeatedly calling the rpc_ns_profile_elt_inq_next() routine. When all the elements have been viewed, this routine returns an rpc_s_no_more_elements status code. The returned elements are unordered.

On each call to this routine that returns a profile element, the RPC run-time system allocates memory for the returned member_name and annotation strings. The application is responsible for calling the rpc_string_free() routine for each returned member_name and annotation string.

After viewing the profile's elements, the application must call the rpc_ns_profile_elt_inq_done() routine to delete the inquiry context.

Permissions Required

The application needs read permission to the the target name service profile entry.

RETURN VALUE

None.

SEE ALSO

rpc_ns_profile_elt_inq_begin()
rpc_ns_profile_elt_inq_done()
rpc_string_free()
rpc_ns_mgmt_set_exp_age().

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.