NAME

rpc_ns_entry_inq_resolution- resolves the cell namespace components of a name and returns partial results

SYNOPSIS

#include <dce/rpc.h>

void rpc_ns_entry_inq_resolution(
    unsigned32 entry_name_syntax,
    unsigned_char_t *entry_name,
    unsigned_char_t **resolved_name,
    unsigned_char_t **unresolved_name,
    unsigned32 *status);

PARAMETERS

Input

entry_name_syntax

An integer value that specifies the syntax of the 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. The value rpc_c_ns_syntax_dce corresponds to the name syntax specified in the DCE: Directory Services specification.

entry_name

The composite entry name on which the attempted name resolution is to be performed.

Input/Output

resolved_name

Returns a pointer to the resolved portion of the entry name. The resolved_name is NULL terminated and does not contain trailing component separators (that is, it contains no trailing / (slash) characters).

Specifying NULL prevents the routine from returning this parameter.

unresolved_name

Returns a pointer to the unresolved portion of the entry name. The unresolved_name is a relative name, not containing leading component separators (that is, it contains no leading / (slash) characters).

Specifying NULL prevents the routine from returning this parameter.

Output

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_partial_results

The entry name was only partially resolved within the cell name space and the value of unresolved_name points to the residual of the name.

rpc_s_unsupported_name_syntax

Unsupported name syntax.

DESCRIPTION

The rpc_ns_entry_inq_resolution() routine attempts to read a name entry in the cell name space. If the read is successful, the full resolution of the entry name is returned. If the read is not successful due to the entry not being found in the cell name space, the partial result of the name resolution is returned, with status code set to rpc_s_partial_results.

If the status code is rpc_s_partial_results and the return parameter resolved_name is not empty, the contents of resolved_name can be used in subsequent calls to the NSI, in order to obtain the binding handle for the name server that controls the name space in which the entry specified by the value of unresolved_name lies.

Permissions Required

The application requires read permission for the name entries that are resolved within the cell name space.

RETURN VALUE

None.

SEE ALSO

rpc_ns_binding_export()
rpc_ns_binding_import_begin()
rpc_ns_binding_import_done()
rpc_ns_binding_import_next()
rpc_ns_binding_inq_entry_name()
rpc_ns_binding_lookup_begin()
rpc_ns_binding_lookup_done()
rpc_ns_binding_lookup_next()
rpc_ns_binding_select()
rpc_ns_binding_unexport().

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.