Inside Macintosh: Interapplication Communication /

Chapter 12 - Data Access Manager / Data Access Manager Reference

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

DBDisposeQuery

When you are finished using a query record, call DBDisposeQuery to dispose of the query record.

FUNCTION DBDisposeQuery (query: QueryHandle): OSErr;

query

A handle to the query record to dispose.

DESCRIPTION

The DBDisposeQuery function disposes of a query record and frees all the memory that the Data Access Manager allocated when it created the query record.

SPECIAL CONSIDERATIONS

The DBDisposeQuery 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 DBDisposeQuery function are

Trap macro	Selector
_DBDisposeQuery	$0210

RESULT CODES

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

SEE ALSO

See Listing 12-1 beginning on page 12-18 for an example of the use of the DBDisposeQuery function in the high-level interface. For a description of the query record, see page 12-57.