NAME

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.

Possible status codes are as follows:

dce_cf_st_ok

dce_cf_e_file_open

dce_cf_e_no_mem

dce_cf_e_no_match

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.

RETURN VALUES

No value is returned.

RELATED INFORMATION

Functions: dce_cf_free_cell_aliases(3dce), dce_cf_get_cell_name(3dce), dce_cf_get_host_name(3dce), dce_cf_same_cell_name(3dce).

Books: OSF DCE Application Development Guide--Core Components, Transarc DCE Command Reference.