dce_cf_get_cell_aliases(3dce)
Returns a list of aliases for the local cell
Synopsis
#include <dce/dce_cf.h>
void dce_cf_get_cell_aliases(
char ***cell_alias_list,
error_status_t *status);
Parameters
Input
None.
Output
cell_alias_list
The address of a string pointer array. This routine sets this address to point to the address of an allocated null-terminated array of pointers to the cell
alias names for the local cell. If no aliases exist, the routine returns NULL in this parameter.
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_cell_aliases( ) routine retrieves the local cell's cell name aliases. If cell aliases are found, the routine returns the address of an
allocated list of cell alias names in the cell_alias_list parameter. If no aliases exist for the cell, the routine returns NULL.
Use the dce_cf_free_cell_aliases( ) routine to free the memory allocated by the dce_cf_get_cell_aliases( ) routine.
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
dce_cf_e_file_open
dce_cf_e_no_mem
dce_cf_e_no_match
Related Information
Functions: dce_cf_free_cell_aliases(3dce)
Books:
OSF DCE Application Development Guide - Core Components