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

  NAME
      dce_cf_profile_entry_from_host - Returns the host profile entry

  SYNOPSIS

      #include <dce/dce_cf.h>

      void dce_cf_profile_entry_from_host( char *hostname,
                                           char **prof_name,
                                           error_status_t *status);

  PARAMETERS

      INPUT

      hostname - Specifies 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

      prof_name - The profile entry 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_profile_entry_from_host() routine returns the profile entry
  string associated with the hostname passed to it. If hostname is NULL,
  the profile entry associated with the name returned by
  dce_cf_get_host_name() is returned.

  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_find_name_by_key
                 dce_cf_get_cell_name
                 dce_cf_get_host_name
                 dce_cf_prin_name_from_host
                 dce_cf_binding_entry_from_host

      BOOKS: OSF DCE Administration Guide.