Legacy Document

Inside Macintosh: PowerPC System Software /

Chapter 3 - Code Fragment Manager / Code Fragment Manager Reference

Code Fragment Manager Routines / Finding Symbols

GetIndSymbol

You can use the GetIndSymbol function to get information about the exported symbols in a fragment.

OSErr GetIndSymbol (ConnectionID connID, long symIndex, 
                     Str255 symName, Ptr *symAddr, 
                     SymClass *symClass);

connID

A connection ID.

symIndex

A symbol index. The value of this parameter should be greater than
or equal to 1 and less than or equal to the value returned by the CountSymbols function.

symName

On exit, the name of the indicated symbol.

symAddr

On exit, the address of the indicated symbol.

symClass

On exit, the class of the indicated symbol.

DESCRIPTION

The GetIndSymbol function returns information about a particular symbol exported by the fragment whose connection ID is connID. If GetIndSymbol executes successfully, it returns the symbol's name, starting address, and class in the symName, symAddr, and symClass parameters, respectively. See the description of the FindSymbol function (page 3-24) for a list of the values that can be returned in the symClass parameter.

A fragment's exported symbols are retrieved in no predetermined order.

RESULT CODES

fragNoErr	0	No error
fragConnectionIDNotFound	-2801	Connection ID is not valid
fragSymbolNotFound	-2802	Symbol was not found in connection