Inside Macintosh: Processes

Chapter 2 - Process Manager / Process Manager Reference

Data Structures

Launch Parameter Block

You specify a launch parameter block as a parameter to the
LaunchApplication function. The launch parameter block is defined
by the LaunchParamBlockRec 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 the launchControlFlags field if you want the LaunchApplication function to extract the Finder flags from the application file and to set the launchFileFlags 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.