EDCS SymbolicConstantToEGCode

EDCS Reference Manual Functions EDCS SymbolicConstantToEGCode

extern EDCS_Status_Code
EDCS_SymbolicConstantToEGCode
(
const	EDCS_Character	*	eg_symbolic_constant_in_ptr,	(notes)
	EDCS_Organization_Schema_Code	*	eo_out_ptr,	(notes)
	EDCS_Group_Code	*	eg_out_ptr	(notes)
);

Definition

Retrieves the {EO, EG} code pair corresponding to the given symbolic constant.

Returns

EDCS_SC_SUCCESS	and eo_out_ptr, eg_out_ptr are set to the appropriate values, if valid parameters were passed in.
EDCS_SC_NULL_REQUIRED_PARAMETER	and no changes are made, if any parameter is NULL.
EDCS_SC_INVALID_INPUT_SYMBOLIC_CONSTANT	and no changes are made, if *eg_symbolic_constant_in_ptr does not correspond to a valid EG for some EO.

Parameters Notes

eg_symbolic_constant_in_ptr

 the symbolic constant for which the
    corresponding EG code is requested; note that this is the
    language-binding symbolic constant name, rather than the
    abstract label (i.e., corresponds to the C language binding
    standard rather than the abstract EDCS specification)

eo_out_ptr

 pointer to a variable in the user's memory into which
       the output EOC will be copied

eg_out_ptr

 pointer to a variable in the user's memory into which
       the output EGC will be copied