rpc_ns_entry_expand_name(3) — Subroutines

NAME

rpc_ns_entry_expand_name - 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_syntaxAn integer value that specifies the syntax of argument entry_name. To use the syntax specified in the RPC_DEFAULT_ENTRY_SYNTAX environment variable, provide a value of rpc_c_ns_syntax_default.

entry_nameSpecifies the entry name to expand. This can be either the global or cell-relative name.

Output

expanded_nameReturns a pointer to the expanded version of argument entry_name. Do not specify NULL since the routine always returns a name string.

statusReturns the status code from this routine. This status code indicates whether the routine completed successfully or, if not, why not. The possible status codes and their meanings are as follows:

rpc_s_okSuccess.

rpc_s_incomplete_name
Incomplete name.

DESCRIPTION

An application calls the rpc_ns_entry_expand_name routine to obtain a fully expanded entry name.

The RPC runtime allocates memory for the returned expanded_name argument. The application is responsible for calling the rpc_string_free routine for that returned argument 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 routine rpc_ns_entry_expand_name, the expanded name could be

/.../abc.com/subsys/PrintQ/server1

Permissions Required

None.

NOTE:

For this release, the RPC naming service (rpc_ns) routines are not implemented, nor is an independent naming service provided.

RETURN VALUES