 |
SymFindHome |
Function (ROM Call 0x62) |
Finds a folder.
SymFindHome searches the folder table part of variable allocation table (VAT)
for a folder named SymName (in fact, it searches through a
pseudo-folder called "home", which contains all other folders).
SymFindHome returns a structure of type HSym,
which contains the handle of the folder table list of the VAT, and the offset
from the beginning of the list to the actual VAT symbol entry. Use
DerefSym to get a pointer to the actual VAT
symbol entry instead. In case of an error (for example, if the folder does
not exist), SymFindHome returns HS_NULL.
Note: I don't know what kernels do to find the handle of the folder
list, but as far as I know, the only legal method is the following:
FolderListHandle = SymFindHome(SYMSTR("main")).folder;
Uses: MakeHSym, SymCmp, ParseSymName, _mu16u16
Used by: cmd_delfold
See also: SymFind