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

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 that is 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 routine rpc_ns_entry_object_inq_next(), and with the routine rpc_ns_entry_object_inq_done(). 

statusReturns 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).