VMS Help DCE_RPC, Application Routines, rpc_ns_entry_expand_name  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 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_syntax
       An integer value that specifies the syntax of the entry_name
       parameter.  To use the syntax specified in the
       RPC_DEFAULT_ENTRY_SYNTAX logical name, 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.  The possible status codes and their meanings are as
       follows:

       rpc_s_ok                     Success.

       rpc_s_incomplete_name        Incomplete name.

 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.

   Permissions Required

   No permissions are required.

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_string_free

   Books: OSF DCE Administration Guide.