NAME

   rpc_ns_entry_object_inq_begin - Creates an inquiry context for viewing
                                   the objects of 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_begin( unsigned32 entry_name_syntax,
                                       unsigned_char_t *entry_name,
                                       rpc_ns_handle_t *inquiry_context,
                                       unsigned32 *status );

 PARAMETERS

   Input

   entry_name_syntax
       An integer value that specifies the syntax of the entry_name
       parameter.  To use the syntax specified in the
       RPC_DEFAULT_ENTRY_SYNTAX logical name, provide a value of
       rpc_c_ns_syntax_default.

   entry_name
       Specifies the entry in the name service database for which object
       UUIDs are viewed.  This can be either the global or cell-relative
       name.

   Output

   inquiry_context
       Returns a name service handle for use with the
       rpc_ns_entry_object_inq_next() routine, and with the
       rpc_ns_entry_object_inq_done() routine.

   status
       Returns the status code from this routine, indicating 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_incomplete_name
                      Incomplete name.

       rpc_s_invalid_name_syntax
                      Invalid name syntax.

       rpc_s_unsupported_name_syntax
                      Unsupported name syntax.

 DESCRIPTION

   The rpc_ns_entry_object_inq_begin() routine creates an inquiry context
   for viewing the object UUIDs exported to entry_name.

   Before calling rpc_ns_entry_object_inq_next(), the application must
   first call this routine to create an inquiry context.

   When finished viewing the object UUIDs, the application calls the
   rpc_ns_entry_object_inq_done() routine to delete the inquiry context.

   Permissions Required

   No permissions are required.

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_ns_binding_export
              rpc_ns_entry_object_inq_done
              rpc_ns_entry_object_inq_next
              rpc_ns_mgmt_handle_set_exp_age