Legacy Documentclose button

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

Previous Book Contents Book Index Next

Inside Macintosh: More Macintosh Toolbox /
Chapter 9 - Desktop Manager / Desktop Manager Reference
Routines / Adding to the Desktop Database


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

FUNCTION PBDTAddAPPL (paramBlock: DTPBPtr; async: Boolean): OSErr;
A pointer to a desktop parameter block.
A Boolean value that specifies asynchronous (TRUE) or synchronous (FALSE) execution.
--> ioCompletionProcPtrA pointer to a completion routine.
\xAE ioResultOSErrThe result code of the function.
--> ioNamePtrStringPtrA pointer to the application's name.
--> ioDTRefNumIntegerThe desktop database reference number.
-->ioTagInfoLongIntReserved; must be set to 0.
--> ioDirIDLongIntThe application's parent directory.
--> ioFileCreatorOSTypeThe application's signature.

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.

noErr0No error
ioErr-36I/O error
fnfErr-43Application not present on volume
wPrErr-44Volume is locked through hardware
vLckdErr-46Volume is locked through software
rfNumErr-51Reference number invalid
extFSErr-58External file system--file system identifier is nonzero

Previous Book Contents Book Index Next

© Apple Computer, Inc.
6 JUL 1996