Legacy Document

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

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.

\xAE 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

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

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

Legacy Document

PBDTCloseDown

DESCRIPTION

RESULT CODES noErr0No error ioErr-36I/O error rfNumErr-51Reference number invalid extFSErr-58External file system--file system identifier is nonzero

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