Important: The information in this document is obsolete and should not be used for new development.
PBDTGetAPPLTo identify the application that can open a file with a given creator, use the
FUNCTION PBDTGetAPPL (paramBlock: DTPBPtr; async: Boolean): OSErr;
- A pointer to a desktop parameter block.
- A Boolean value that specifies asynchronous (
TRUE) or synchronous (
--> ioCompletion ProcPtr A pointer to a completion routine. \xAE ioResult OSErr The result code. --> ioNamePtr StringPtr A pointer to the application's name. --> ioDTRefNum Integer The desktop database reference number. --> ioIndex Integer An index into the application list. \xAE ioTagInfo LongInt The application's creation date. --> ioFileCreator OSType The application's signature. \xAE ioAPPLParID LongInt The application's parent directory.
DESCRIPTIONFor an application in the database specified in
ioDTRefNumwith the signature specified in
PBDTGetAPPLreturns the filename in
ioNamePtr, the parent directory ID in
ioAPPLParID, and the creation date in
ioTagInfo. A single call, with
ioIndexset to 0, finds the application file with the most recent creation date. If you want to retrieve information about all copies of the application with the given signature, start with
ioIndexset to 1 and increment until
afpItemNotFound; when called multiple times in this fashion,
PBDTGetAPPLreturns information about all the application's copies, including the file with the most recent creation date, in arbitrary order.
noErr 0 No error ioErr -36 I/O error rfNumErr -51 Reference number invalid extFSErr -58 External file system--file system identifier is nonzero afpItemNotFound -5012 Information not found