Inside Macintosh: More Macintosh Toolbox /

Chapter 9 - Desktop Manager / Desktop Manager Reference

Routines / Locating, Opening, and Closing the Desktop Database

PBDTCloseDown

The PBDTCloseDown function is used by system software to close the desktop database, though your application should never do this itself. PBDTCloseDown runs synchronously only, and though it will not close down the desktop databases of remote volumes, it will invalidate all local DTRefNum values for remote desktop databases.

FUNCTION PBDTCloseDown (paramBlock: DTPBPtr): OSErr;

paramBlock

A pointer to a desktop parameter block.

�	ioResult	OSErr	The result code of the function.
-->	ioDTRefNum	Integer	The desktop database reference number.

DESCRIPTION

The PBDTCloseDown function closes the database specified in ioDTRefNum and frees all resources allocated by PBDTOpenInform or PBDTGetPath.

WARNING

Applications should not call PBDTCloseDown. The system software closes the database when the volume is unmounted.

RESULT CODES

noErr	0	No error
ioErr	-36	I/O error
rfNumErr	-51	Reference number invalid
extFSErr	-58	External file system--file system identifier is nonzero