Folderop - Texas Instruments TI-89 Developer's Manual

1020

FolderOp

Declaration: BOOL FolderOp (const BYTE * FolderName , WORD Operation )
Category(ies): Symbol Table Utilities (low level)
Description: Lock or unlock folders.
Inputs: FolderName — Tokenized name of folder to operate on.
Operation
If Operation is OR'd with FL_ALL then all folders are either locked or
unlocked with FolderName being ignored in that case.
TRUE if operation successful, FALSE if FolderName not found.
Outputs:
None
Assumptions:
Side Effects: None
Availability: All versions of the TI-89 / TI-92 Plus.
TI-89 / TI-92 Plus
Differences: None
See Also: None
Example: See SymFindFirst.
That example locks the HOME folder (the folder that contains all of the
folders) since it uses SymFindFirst that returns direct pointers to the
symbol table. It also allocates memory from the heap which could possibly
move the symbol table. Therefore, it locks the HOME folder, walks through
all of the folders in the HOME folder, and then unlocks the HOME folder.
TI-89 / TI-92 Plus Developer Guide
Appendix A: System Routines — Symbol Table Utilities
— FL_UNLOCK — Unlock the given folder.
FL_LOCK
Not for Distribution
— Lock the given folder.
Beta Version January 26, 2001