Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

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 macroSelector
_DBResultsToText$0413

RESULT CODES
noErr0No error
rcDBPackNotInited-813The 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.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996