rpc_ns_entry_object_inq_begin(3rpc)

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)