Legacy Document

Inside Macintosh: Interapplication Communication /

Chapter 12 - Data Access Manager / Data Access Manager Reference

Data Access Manager Routines / High-Level Interface: Handling Query Results

DBResultsToText

After retrieving a results record from DBGetQueryResults, you can use the DBResultsToText function to convert the returned data to text.

FUNCTION DBResultsToText (results: ResultsRecord; 
                          VAR theText: Handle): OSErr;

results

The results record returned by the DBGetQueryResults function.

theText

The DBResultsToText function returns a handle to the converted text in this parameter. This handle is allocated by the Data Access Manager.

DESCRIPTION

The DBResultsToText function calls result handlers to convert to text the data retrieved by the DBGetQueryResults function.

SPECIAL CONSIDERATIONS

The DBResultsToText function may move or purge memory. You should not call this routine from within an interrupt, such as in a completion routine or a VBL task.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the DBResultsToText function are

Trap macro	Selector
_DBResultsToText	$0413

RESULT CODES

noErr	0	No error
rcDBPackNotInited	-813	The InitDBPack function has not yet been called

SEE ALSO

See Listing 12-1 begining on page 12-18 for an example of the use of the DBResultsToText function. See "Converting Query Results to Text" beginning on page 12-43 for a discussion of result handlers.