Previous section.

CDE 1.1: Remote Procedure Call
Copyright © 1997 The Open Group

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.

Contents Next section Index