| ## rpc_ns_entry_object_inq_begin(3rpc) 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 environment variable, 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. 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. Errors The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 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. Related Information Functions: rpc_ns_binding_export(3rpc) rpc_ns_entry_object_inq_done(3rpc) rpc_ns_entry_object_inq_next(3rpc) rpc_ns_mgmt_handle_set_exp_age(3rpc) ##