Product Documentation

FairCom ISAM for C

Previous Topic

Next Topic

WhichCtree

Return the current c-tree 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 Error Codes c-tree Programmer’s Reference Guide for a complete listing of valid c-tree error values.

Example

pCTGVAR ctWNGV;


ctWNGV = GetCtreePointer(WhichCtree());

isam_err = ctWNGV->sisam_err

See also

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

TOCIndex