NAME

rpc_ns_entry_expand_name- returns a canonicalised version of an entry name

SYNOPSIS

#include <dce/rpc.h>

void rpc_ns_entry_expand_name(
	unsigned32 entry_name_syntax,
	unsigned_char_t *entry_name,
	unsigned_char_t **expanded_name,
	unsigned32 *status);

PARAMETERS

Input

entry_name_syntax

Specifies the syntax of argument entry_name. (See Name Syntax Constants for the possible values of this argument.)

An application can supply the value rpc_c_ns_syntax_default to use the syntax specified by the RPC_DEFAULT_ENTRY_SYNTAX environment variable.

entry_name

The name of the entry to canonicalise. The entry name syntax is identified by the argument entry_name_syntax.

Output

expanded_name

Returns a pointer to the canonicalised version of argument entry_name.

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.

DESCRIPTION

An application calls the rpc_ns_entry_expand_name() routine to obtain a canonicalised version of an entry name. Canonicalisation rules depend on the underlying name service.

The RPC run-time system allocates memory for the returned expanded_name. The application is responsible for calling the rpc_string_free() routine to free this memory.

Permissions Required

None.

RETURN VALUE

None.

SEE ALSO

rpc_string_free().

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.