NAME

rpc_ns_profile_elt_inq_next - Returns one element at a time from a profile

Used by client, server, or management applications. 

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_contextSpecifies a name service handle.  This handle is returned from the rpc_ns_profile_elt_inq_begin routine. 

Output

if_idReturns the interface identifier of the profile element. 

member_nameReturns a pointer to the profile element’s member name.  The name is a global name.  The syntax of the returned name is specified by the member_name_syntax argument in the rpc_ns_profile_elt_inq_begin routine.  Specify NULL to prevent the routine from returning this argument. In this case the application does not call the rpc_string_free routine. 

priorityReturns the profile element priority. 

annotationReturns the annotation string for the profile element. If there is no annotation string in the profile element, the string \0 is returned.  Specify NULL to prevent the routine from returning this argument. In this case the application does not need to 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. 

rpc_s_entry_not_foundName service entry not found. 

rpc_s_incomplete_nameIncomplete name. 

rpc_s_invalid_ns_handleInvalid name service handle. 

rpc_s_name_service_unavailable
Name service unavailable.

rpc_s_no_more_elementsNo more elements. 

rpc_s_no_ns_permissionNo 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 runtime allocates memory for the returned member_name (which points to a global 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

You need read permission to the CDS object entry (the target profile entry). 

NOTE:

For this release, the RPC naming service (rpc_ns) routines are not implemented, nor is an independent naming service provided. 

RETURN VALUES

None. 

RELATED INFORMATION

Functions: rpc_ns_profile_elt_begin(3), rpc_ns_profile_elt_done(3), rpc_string_free(3)