| ## dce_cf_get_csrgy_filename(3dce) Returns the path name 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 path name 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. Description The dce_cf_get_csrgy_filename( ) routine is a DCE function that returns the path name of a code set registry file that has been created on a given host with the csrc utility. DCE RPC routines for code set interoperability 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( ). Files dcelocal/dce_cf.db The machine's local DCE configuration file (where dcelocal is usually something like /opt/dcelocal). Errors The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. dce_cf_st_ok Operation successfully completed. dce_cf_e_file_open File open error. dce_cf_e_no_mem No memory available. Related Information Functions: dce_cf_get_cell_name(3dce) dce_cf_find_name_by_key(3dce) dce_cf_get_host_name(3dce) dce_cf_prin_name_from_host(3dce) rpc_rgy_get_codesets(3rpc) Commands: csrc(8dce) Book: OSF DCE Administration Guide - Core Components ##