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: 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.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
17 JUN 1996