PBDTAddAPPLSync
PBDTAddAPPL Add an application to the desktop database. DTPBPtr paramBlock ; pointer to a DTPB Param Block
Boolean async; 0 = await completion; 1 = immediate return Parameter block
ۮ 12 ioCompletion long completion routine
۬ 16 ioResult short result code
ۮ 18 ioNamePtr long pointer to application's name
ۮ 24 ioDTRefNum short desktop database reference number
ۮ 28 ioTagInfo long reserved; must be set to 0
ۮ 48 ioDirID long application's parent directory
ۮ 52 ioFileCreator long application's signature PBDTAddAPPL 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
Returns: an Error code. It will be one of the following:
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
Note: There is a second, asynchronous, version of this function. It does not take a
second parameter; instead, it adds the suffix "Async" to the name of the
routine.
Similarly, the third (synchronous) version of the routine does not take a
second parameter; instead, it adds the suffix "Sync" to the name of the
routine.
Note, however, that the second and third versions of these routines do not
use the glue code that the first versions use and are therefore more
efficient.