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

  NAME
      dce_cf_binding_entry_from_host - Returns the host binding entry
                                       name

  SYNOPSIS

      #include <dce/dce_cf.h>

      void dce_cf_binding_entry_from_host( char *hostname,
                                           char **entry_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

      entry_name - The binding entry 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_binding_entry_from_host() routine returns the binding entry
  name string associated with the hostname passed to it. If hostname is
  NULL, the binding entry name 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

      BOOKS: OSF DCE Administration Guide.

      FUNCTIONS: dce_cf_find_name_by_key
                 dce_cf_get_cell_name
                 dce_cf_get_host_name
                 dce_cf_prin_name_from_host