NAME

rpc_ns_entry_object_inq_begin- creates an inquiry context for viewing the objects of an entry in the name service database

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 argument entry_name. (See Name Syntax Constants for the possible values of this argument.)

The value rpc_c_ns_syntax_default specifies the syntax specified by the RPC_DEFAULT_ENTRY_SYNTAX environment variable.

entry_name

The name of the entry in the name service database for which object UUIDs are viewed. The entry name syntax is identified by the argument entry_name_syntax.

Output

inquiry_context

Returns an inquiry context for use with routines rpc_ns_entry_object_inq_next() and rpc_ns_entry_object_inq_done().

status

Returns the status code from this routine. The status code indicates whether the routine completed successfully, or if not, why not.

Possible status codes and their meanings include:

rpc_s_ok

Success.

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 the rpc_ns_entry_object_inq_next() routine, 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

None.

RETURN VALUE

None.

SEE ALSO

rpc_ns_binding_export()
rpc_ns_entry_object_inq_done()
rpc_ns_entry_object_inq_next()
rpc_ns_mgmt_handle_set_exp_age().

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.