Important: The information in this document is obsolete and should not be used for new development.
Launch Parameter Block
You specify a launch parameter block as a parameter to theLaunchApplication
function. The launch parameter block is defined
by theLaunchParamBlockRec
data type.
TYPE LaunchParamBlockRec = RECORD reserved1: LongInt; {reserved} reserved2: Integer; {reserved} launchBlockID: Integer; {extended block} launchEPBLength: LongInt; {length of block} launchFileFlags: Integer; {app's Finder flags} launchControlFlags: LaunchFlags; {launch options} launchAppSpec: FSSpecPtr; {location of app's file} launchProcessSN: ProcessSerialNumber; {returned psn} launchPreferredSize: LongInt; {returned pref size} launchMinimumSize: LongInt; {returned min size} launchAvailableSize: LongInt; {returned avail size} launchAppParameters: AppParametersPtr; {high-level event} END;
Field Description
reserved1
- Reserved.
reserved2
- Reserved.
launchBlockID
- A value that indicates whether you are using the fields following it in the launch parameter block. Specify the constant
extendedBlock
if you use the fields that follow it.
launchEPBLength
- The length of the fields following this field in the launch parameter block. Use the constant
extendedBlockLen
to specify this value.
launchFileFlags
- The Finder flags for the application file. Set the
launchNoFileFlags
constant in thelaunchControlFlags
field if you want theLaunchApplication
function to extract the Finder flags from the application file and to set thelaunchFileFlags
field for you.
launchControlFlags
- The launch options that determine how the application is launched. You can specify these constant values to set various options:
CONST launchContinue = $4000; launchNoFileFlags = $0800; launchUseMinimum = $0400; launchDontSwitch = $0200; launchInhibitDaemon = $0080;
- See "Launch Options" on page 2-15 for a complete description of these flags.
launchAppSpec
- A pointer to a file specification record that gives the location of the application file to launch.
launchProcessSN
- The process serial number returned to your application if the launch is successful. You can use this process serial number in other Process Manager routines to refer to the launched application.
launchPreferredSize
- The preferred partition size for the launched application as specified in the launched application's
'SIZE'
resource.LaunchApplication
sets this field to 0 if an error occurred or if the application is already open.
launchMinimumSize
- The minimum partition size for the launched application as specified in the launched application's
'SIZE'
resource.LaunchApplication
sets this field to 0 if an error occurred or if the application is already open.
launchAvailableSize
- The maximum partition size that is available for allocation. This value is returned to your application only if the
memFullErr
result code is returned. If the application launch fails because of insufficient memory, you can use this value to determine if there is enough memory available to launch in the minimum size.
launchAppParameters
- The first high-level event to send to the launched application. If you set this field to
NIL
,LaunchApplication
creates and sends the Open Application Apple event to the launched application.