NAME
      dce_cf_dced_entry_from_host - Returns the dced entry name on a host

  SYNOPSIS

      #include <dce/dce_cf.h>

      void dce_cf_dced_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 this value is NULL, the value
                 returned by dce_cf_get_host_name is used.

      OUTPUT

      entry_name - The dced entry name associated with the specified
                   host.  Storage for this name is dynamically allocated;
                   release it with free() when you no longer need it.

      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_dced_entry_from_host() routine returns the name entered into
  the DCE namespace for a DCE host daemon (dced) on the host specified by
  the hostname parameter.  If the hostname parameter is NULL, the dced
  name associated with the name returned by dce_cf_get_host_name() is
  returned.  The string name is of the form /.:/hosts/hostname/config,
  and specifies the entry point into the dced namespace on the host.
  This is the location in the DCE namespace at which dced stores the
  objects associated with the host services it provides (the hostdata,
  srvrconf, srvrexec, secval, and keytab services, as well as ACL
  editing).  It is also an actual name in the DCE namespace that you can
  import if you want to create your own RPC binding to dced.

  You can use the dced entry name returned by this routine as input to
  the dced_binding_create() routine, input to sec_acl_* routines, or to
  rpc_ns_binding_import_* routines to establish a binding to a dced host
  service.

  If using dced_binding_create(), you append a service name to the entry
  returned by this routine. If using sec_acl_* routines, you append the
  service and the object name. If using rpc_ns_binding_import_*, you use
  only the entry returned by the routine.

  You can also use the returned string to name objects that dced
  maintains, for example, when editing these objects' ACLs with dcecp.
  For example, the string name /.:/hosts/vineyard/config/srvrconf/dtsd
  names the server configuration data for the DTS server on the host
  vineyard.

  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
                 dce_cf_prin_name_from_host
                 dced_binding_create

      BOOKS: OSF DCE Application Development Guide-Core Components
             OSF DCE Com mand Reference.