VMS Help DCE, dce_intro, dce_cf_intro, dce_cf_prin_name_from_host  *Conan The Librarian (sorry for the slow response - running on an old VAX)

  NAME
      dce_cf_prin_name_from_host - Returns the host's principal name

  SYNOPSIS

      #include <dce/dce_cf.h>

      void dce_cf_prin_name_from_host( char *hostname,
                                       char **prin_name,
                                       error_status_t *status);

  PARAMETERS

      INPUT

      hostname - The name of the host.  Note that host names are case
                 sensitive.  If NULL, the configuration file is searched
                 for the hostname, and that name, if found, is used.

      OUTPUT

      prin_name - The principal name associated with the specified host.

      status - Returns the status code from this operation. The status
               code is a value that indicates whether the routine
               completed successfully and if not, why not.
               Possible status codes and their meanings are as follows:

               dce_cf_st_ok           Operation completed successfully.

               dce_cf_e_file_open     File open error.

               dce_cf_e_no_mem        No memory available.

               dce_cf_e_no_match      No hostname entry in the DCE
                                      configuration file.

  DESCRIPTION

  The dce_cf_prin_name_from_host() routine returns the principal name
  associated with the hostname passed to it.  If hostname is NULL,
  dce_cf_prin_name_from_host() returns the principal name associated
  with the name returned by dce_cf_get_host_name().

  FILES

      DCE$LOCAL:[000000]dce_cf.db
            The machine's local DCE configuration file (where dcelocal is
            usually something like DIA0:[SYS0.DCELOCAL.]).

  RETURN VALUES

      No value is returned.

  RELATED INFORMATION

      FUNCTIONS: dce_cf_binding_entry_from_host
                 dce_cf_find_name_by_key
                 dce_cf_get_cell_name
                 dce_cf_get_host_name

      BOOKS: OSF DCE Administration Guide.