Legacy Document

Inside Macintosh: More Macintosh Toolbox /

Chapter 9 - Desktop Manager / Desktop Manager Reference

Routines / Deleting Entries From the Desktop Database

PBDTRemoveAPPL

To remove an application from the desktop database, call the PBDTRemoveAPPL function.

FUNCTION PBDTRemoveAPPL (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.
-->	ioNamePtr	StringPtr	A pointer to the application's name.
-->	ioDTRefNum	Integer	The desktop database reference number.
-->	ioDirID	LongInt	The application's parent directory.
-->	ioFileCreator	OSType	The application's signature.

DESCRIPTION

The PBDTRemoveAPPL function removes the mapping information for an application from the database specified in ioDTRefNum. You specify the application's name through ioNamePtr, its parent directory ID in ioDirID, and its signature in ioFileCreator.

You can call PBDTRemoveAPPL even if the application is not present 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
afpItemNotFound	-5012	Application not found