rpc_ns_entry_expand_name(3rpc)
Expands the name of a name service entry
Used by client, server, or management applications.
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
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 name to expand. This can be either the global or cell-relative name.
Output
expanded_name
Returns a pointer to the expanded version of entry_name. Do not specify NULL since the routine always returns a name string.
status
Returns the status code from this routine. This status code indicates whether the routine completed successfully or, if not, why not.
Description
An application calls rpc_ns_entry_expand_name( ) to obtain a fully expanded entry name.
The RPC runtime allocates memory for the returned expanded_name parameter. The application is responsible for calling rpc_string_free( ) for that returned parameter string.
The returned and expanded entry name accounts for local name translations and differences in locally defined naming schemas. For example, suppose the entry in the name service is
/.:/subsys/PrintQ/server1
Upon return from rpc_ns_entry_expand_name( ), the expanded name could be
/.../abc.com/subsys/PrintQ/server1
For more information about local names and their expansions, see the information on the DCE Directory Service in the OSF DCE Administration Guide - Core Components.
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.
Related Information
Functions: rpc_string_free(3rpc)
Books: OSF DCE Administration Guide - Introduction