VMS Help DCE_RPC, Application Routines, rpc_ns_entry_object_inq_next  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME

   rpc_ns_entry_object_inq_next - Returns one object at a time from an
                                  entry in the name service database

   Used by client, server, or management applications.

 SYNOPSIS

   #include <dce/rpc.h>

   void rpc_ns_entry_object_inq_next( rpc_ns_handle_t inquiry_context,
                                      uuid_t *obj_uuid,
                                      unsigned32 *status );

 PARAMETERS

   Input

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

   Output

   obj_uuid
       Returns an exported object UUID.

   status
       Returns 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_ok       Success.

       rpc_s_class_version_mismatch
                      RPC class version mismatch.

       rpc_s_entry_not_found
                      Name service entry not found.

       rpc_s_incomplete_name
                      Incomplete name.

       rpc_s_invalid_ns_handle
                      Invalid name service handle.

       rpc_s_name_service_unavailable
                      Name service unavailable.

       rpc_s_no_more_members
                      No more members.

       rpc_s_no_ns_permission
                      No permission for name service operation.

       rpc_s_not_rpc_entry
                      Not an RPC entry.

 DESCRIPTION

   The rpc_ns_entry_object_inq_next() routine returns one of the object
   UUIDs exported to an entry in the name service database.  The entry_name
   parameter in the rpc_ns_entry_object_inq_begin() routine specified the
   entry.

   An application can view all of the exported object UUIDs by repeatedly
   calling the rpc_ns_entry_object_inq_next() routine. When all the object
   UUIDs are viewed, this routine returns an rpc_s_no_more_members status.
   The returned object UUIDs are unordered.

   The application supplies the memory for the object UUID returned in the
   obj_uuid parameter.

   After viewing the object UUIDs, the application must call the
   rpc_ns_entry_object_inq_done() routine to delete the inquiry context.

   The order in which rpc_ns_entry_object_inq_next() returns object UUIDs
   can be different for each viewing of an entry.  Therefore, the order
   in which an application receives object UUIDs can be different each
   time the application is run.

   Permissions Required

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

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_ns_binding_export
              rpc_ns_entry_object_inq_begin
              rpc_ns_entry_object_inq_done