SymFindHome Function (ROM Call 0x62)

vat.h

HSym SymFindHome (SYM_STR SymName);

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