Legacy Document

Inside Macintosh: More Macintosh Toolbox /

Chapter 9 - Desktop Manager / Desktop Manager Reference

Routines / Manipulating the Desktop Database Itself

PBDTFlush

To save your changes to the desktop database, use the PBDTFlush function.

FUNCTION PBDTFlush (paramBlock: DTPBPtr; async: Boolean): OSErr;

paramBlock

A pointer to a desktop parameter block.

async

A Boolean value that specifies asynchronous (TRUE) or synchronous (FALSE) execution.

-->	ioCompletion	ProcPtr	A pointer to a completion routine.
\xAE	ioResult	OSErr	The result code of the function.
-->	ioDTRefNum	Integer	The desktop database reference number.

DESCRIPTION

The PBDTFlush function writes the contents of the desktop database specified in ioDTRefNum to the volume.

Note

If your application has manipulated information in the database using any of the routines described in "Adding to the Desktop Database" or "Deleting Entries From the Desktop Database" beginning on page 9-17 and page 9-20, respectively, you must call PBDTFlush to update the copy stored on the volume.

RESULT CODES

noErr	0	No error
ioErr	-36	I/O error
wPrErr	-44	Volume is locked through hardware
vLckdErr	-46	Volume is locked through software
rfNumErr	-51	Reference number invalid
extFSErr	-58	External file system--file system identifier is nonzero