1020
Appendix A: System Routines — Symbol Table Utilities
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
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
— FL_UNLOCK — Unlock the given folder.
FL_LOCK — Lock the given folder.
If
Operation
is OR’d with FL_ALL then all folders are either locked or
unlocked with
FolderName
being ignored in that case.
Outputs:
TRUE if operation successful, FALSE if
FolderName
not found.
Assumptions:
None
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.