WhichCtree

Return the current c-tree Plus instance reference name.

Short Name

WCHCTREE()

Type

Low-level function

Declaration

  pTEXT WhichCtree()

Description

WhichCtree() returns the active instance reference name. This is useful for displaying the active instance during program execution.

Return

WhichCtree() returns the pointer to the current instance reference name. This is the same instance reference name passed to RegisterCtree(). If there are no active instances, a NULL will be returned. See “c-tree Plus Error Codes” c-tree Plus Programmer’s Reference Guide for a complete listing of valid c-tree Plus error values.

Example

pCTGVAR     ctWNGV;

ctWNGV = GetCtreePointer(WhichCtree());

isam_err = ctWNGV->sisam_err

See also

NextCtree(), RegisterCtree(), SwitchCtree(), UnRegisterCtree(), GetCtreePointer()