dce_cf_same_cell_name(3dce)
Indicates whether or not two cell names refer to the same cell
Synopsis
#include <dce/dce_cf.h>
void dce_cf_same_cell_name(
char *cell_name1,
char *cell_name2,
boolean result,
error_status_t *status);
Parameters
Input
cell_name1
A character string that specifies the name of a cell.
cell_name2
A character string that specifies the name of a cell to compare with cell_name1. If this value is NULL, the routine determines whether or not the
cell name specified in cell_name1 is the name of the local cell.
Output
result
A boolean value that indicates whether or not the specified cell names match, when two cell names are given, and indicates whether or not the specified cell name is the
name of the local cell, when only one cell name is given. A value of TRUE indicates that the cell names refer to the same cell.
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_same_cell_name ( ) routine, when given the names of two cells as input parameters, compares the cell names to determine whether or not they refer
to the same call. The result parameter is set to TRUE if they do, and to FALSE if they do not.
If only one cell name is specified as an input parameter, the dce_cf_same_cell_name( ) routine determines whether or not the specified cell name is the same as the local cell's primary name (which it retrieves by calling dce_cf_get_cell_name( )). You can use the routine in this way to determine whether a given cell name is the primary name of your local cell.
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_no_match
Related Information
Functions: dce_cf_free_cell_aliases(3dce)
Books:
OSF DCE Application Development Guide - Core Components