Legacy Document

Inside Macintosh: More Macintosh Toolbox /

Chapter 9 - Desktop Manager / Desktop Manager Reference

Routines / Adding to the Desktop Database

PBDTAddAPPL

To add an application to the desktop database, use the PBDTAddAPPL function.

FUNCTION PBDTAddAPPL (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.
-->	ioTagInfo	LongInt	Reserved; must be set to 0.
-->	ioDirID	LongInt	The application's parent directory.
-->	ioFileCreator	OSType	The application's signature.

DESCRIPTION

The PBDTAddAPPL function adds an entry in the desktop database specified in ioDTRefNum for an application with the specified signature. You pass the application's signature in ioFileCreator, a pointer to the application's filename in ioNamePtr, and the application's parent directory ID in ioDirID. Initialize ioTagInfo to 0.

RESULT CODES

noErr	0	No error
ioErr	-36	I/O error
fnfErr	-43	Application not present on volume
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