Carbon


LaunchParamBlockRec

Header: Processes.h

struct LaunchParamBlockRec {
    UInt32 reserved1; 
    UInt16 reserved2; 
    UInt16 launchBlockID; 
    UInt32 launchEPBLength; 
    UInt16 launchFileFlags; 
    LaunchFlags launchControlFlags; 
    FSSpecPtr launchAppSpec; 
    ProcessSerialNumber launchProcessSN; 
    UInt32 launchPreferredSize; 
    UInt32 launchMinimumSize; 
    UInt32 launchAvailableSize; 
    AppParametersPtr launchAppParameters;
};
typedef LaunchParamBlockRec LaunchPBPtr;

Field descriptions

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

See “Launch Options” for a complete description of these flags.

launchAppSpec

A pointer to a file specification structure 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 functions 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 NULL, LaunchApplication creates and sends the Open Application Apple event to the launched application.

You specify a launch parameter block as a parameter to the LaunchApplication function. The launch parameter block is defined by the LaunchParamBlockRec data type.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)