NAME
      dce_cf_get_csrgy_filename - Returns the pathname of the code set
                                  registry file on a host

  SYNOPSIS

      #include <dce/dce_cf.h>

      void dce_cf_get_csrgy_filename( char **csrgy_filename,
                                      error_status_t *status);

  PARAMETERS

      INPUT

      None.

      INPUT/OUTPUT

      csrgy_filename - The address of a string pointer. This pointer
                       will be set by the function to point to a buffer
                       that contains the pathname to the code set
                       registry file.

      OUTPUT

      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 successfully completed.

               dce_cf_e_file_open     File open error.

               dce_cf_e_no_mem        No memory available.

  DESCRIPTION

  The dce_cf_get_csrgy_filename() routine is a DCE function that returns
  the pathname of a code set registry file that has been created on a
  given host with the csrc utility.  DCE RPC routines for code set inter-
  operability use this routine when they need to locate a host's code set
  registry file in order to map between unique code set identifiers and
  their operating system-specific local code set names, or to obtain
  supported code sets for a client or server. User-written code set
  interoperability routines can also use the routine.

  The dce_cf_get_csrgy_filename() routine searches the DCE configuration
  file for the name of the local host's code set registry file, allocates
  a buffer for it (by a call to malloc()), copies the name into the
  buffer, and returns its address in the csrgy_filename input parameter.

  CAUTIONS

  The memory for a returned name string is allocated by malloc(), and
  must be freed by the caller of dce_cf_get_csrgy_filename().

  The DCE 1.0 verion of this routine is limited to processing lines of
  text whose length is less than 1024 characters.

  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_get_cell_name
                  dce_cf_find_name_by_key
                  dce_cf_get_host_name
                  dce_cf_prin_name_from_host
                  dce_loc_to_rgy
                  dce_rgy_to_loc
                  rpc_rgy_get_codesets

      COMMANDS: csrc.

      BOOKS: OSF DCE Administration Guide.