Retired Document
Important: This sample code may not represent best practices for current development. The project may use deprecated symbols and illustrate technologies and techniques that are no longer recommended.
MoreIsBetter parts/MoreProcesses.cp
/* |
File: MoreProcesses.cp |
Contains: Process Manager utilities. |
DRI: George Warner |
Copyright: Copyright (c) 1998-2001 by Apple Computer, Inc., All Rights Reserved. |
Disclaimer: IMPORTANT: This Apple software is supplied to you by Apple Computer, Inc. |
("Apple") in consideration of your agreement to the following terms, and your |
use, installation, modification or redistribution of this Apple software |
constitutes acceptance of these terms. If you do not agree with these terms, |
please do not use, install, modify or redistribute this Apple software. |
In consideration of your agreement to abide by the following terms, and subject |
to these terms, Apple grants you a personal, non-exclusive license, under AppleÕs |
copyrights in this original Apple software (the "Apple Software"), to use, |
reproduce, modify and redistribute the Apple Software, with or without |
modifications, in source and/or binary forms; provided that if you redistribute |
the Apple Software in its entirety and without modifications, you must retain |
this notice and the following text and disclaimers in all such redistributions of |
the Apple Software. Neither the name, trademarks, service marks or logos of |
Apple Computer, Inc. may be used to endorse or promote products derived from the |
Apple Software without specific prior written permission from Apple. Except as |
expressly stated in this notice, no other rights or licenses, express or implied, |
are granted by Apple herein, including but not limited to any patent rights that |
may be infringed by your derivative works or by other works in which the Apple |
Software may be incorporated. |
The Apple Software is provided by Apple on an "AS IS" basis. APPLE MAKES NO |
WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED |
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND OPERATION ALONE OR IN |
COMBINATION WITH YOUR PRODUCTS. |
IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL OR |
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE |
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) |
ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, MODIFICATION AND/OR DISTRIBUTION |
OF THE APPLE SOFTWARE, HOWEVER CAUSED AND WHETHER UNDER THEORY OF CONTRACT, TORT |
(INCLUDING NEGLIGENCE), STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN |
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
Change History (most recent first): |
$Log: MoreProcesses.cp,v $ |
Revision 1.8 2001/11/07 15:54:47 eskimo1 |
Tidy up headers, add CVS logs, update copyright. |
<7> 21/9/01 Quinn Changes for CWPro7 Mach-O build. |
<6> 20/3/00 Quinn Added MoreProcIsProcessAtFront. Tidied up some copy and paste |
errors in the comments. Support passing nil to more routines to |
mean "current process". |
<5> 3/9/00 gaw API changes for MoreAppleEvents |
<4> 6/3/00 Quinn Added MoreProcGetProcessAppFile. |
<3> 1/22/99 PCG TARGET_CARBON |
<2> 11/11/98 PCG fix header |
<1> 11/10/98 PCG first big re-org at behest of Quinn |
Old Change History (most recent first): |
<3> 11/9/98 PCG fix comment 2 |
<2> 11/9/98 PCG add copyright blurb |
<1> 6/16/98 PCG initial checkin |
*/ |
#include "MoreSetup.h" |
#include "MoreProcesses.h" |
/****************************************************************************** |
Return a ProcessSerialNumber for a process whose signature (creator) |
matches the input values. This routine will find the first process that |
matches the creator. |
The ProcessSerialNumber will be kNoProcess is the requested process cannot |
be found. |
pCreator input: The creator of the process to be found. |
pPSN input: Pointer to a ProcessSerialNumber. |
output: A valid PSN or kNoProcess in no match is found. |
RESULT CODES |
____________ |
noErr 0 No error |
procNotFound Ð600 No process matched specified creator |
____________ |
*/ |
pascal OSStatus MoreProcFindProcessByCreator(const OSType pCreator,ProcessSerialNumber *pPSN) |
{ |
OSStatus anErr = noErr; |
if (!(MoreAssert (pPSN))) |
anErr = paramErr; |
else |
{ |
pPSN->lowLongOfPSN = kNoProcess; |
pPSN->highLongOfPSN = kNoProcess; |
while (!(anErr = GetNextProcess (pPSN))) |
{ |
ProcessInfoRec pir; |
if (!(anErr = MoreProcGetProcessInformation (pPSN,&pir))) |
if (pCreator == pir.processSignature) |
break; |
} |
} |
return anErr; |
} |
/****************************************************************************** |
Return a ProcessSerialNumber for a process whose signature (type and creator) |
matches the input values. This routine will find the first process that |
matches the type and creator. |
The ProcessSerialNumber will be kNoProcess is the requested process cannot |
be found. |
pCreator input: The creator type of the process to be found. |
pType input: The file type of the process to be found. |
pPSN input: Pointer to a ProcessSerialNumber. |
output: A valid PSN or kNoProcess in no match is found. |
RESULT CODES |
____________ |
noErr 0 No error |
procNotFound Ð600 No process matched specified type and creator |
____________ |
*/ |
pascal OSStatus MoreProcFindProcessBySignature(const OSType pCreator,const OSType pType,ProcessSerialNumber *pPSN) |
{ |
OSStatus anErr = noErr; |
if (!(MoreAssert (pPSN))) |
anErr = paramErr; |
else |
{ |
pPSN->lowLongOfPSN = kNoProcess; |
pPSN->highLongOfPSN = kNoProcess; |
while (!(anErr = GetNextProcess (pPSN))) |
{ |
ProcessInfoRec pir; |
if (!(anErr = MoreProcGetProcessInformation (pPSN,&pir))) |
if ((pCreator == pir.processSignature) && (pType == pir.processType)) |
break; |
} |
} |
return anErr; |
} |
/****************************************************************************** |
Returns the name of the process specified by ProcessSerialNumberPtr. |
The string pointed to by pProcessName will be untouched if the process |
can't be found. |
pPSN input: The process whose name you want (nil for current). |
pProcessName input: Pointer to a Str31 for the process name. |
output: The process name. |
RESULT CODES |
____________ |
noErr 0 No error |
paramErr Ð50 Process serial number is invalid |
____________ |
*/ |
pascal OSStatus MoreProcGetProcessName( |
const ProcessSerialNumberPtr pPSN, |
StringPtr pProcessName) |
{ |
OSStatus anErr = noErr; |
ProcessInfoRec infoRec; |
ProcessSerialNumber localPSN; |
MoreAssertQ(pProcessName != nil); |
infoRec.processInfoLength = sizeof(ProcessInfoRec); |
infoRec.processName = pProcessName; |
infoRec.processAppSpec = nil; |
if ( pPSN == nil ) { |
localPSN.highLongOfPSN = 0; |
localPSN.lowLongOfPSN = kCurrentProcess; |
} else { |
localPSN = *pPSN; |
} |
anErr = GetProcessInformation(&localPSN, &infoRec); |
return anErr; |
}//end MoreProcGetProcessName |
/****************************************************************************** |
Returns information about the process specified by ProcessSerialNumberPtr. |
pProcessType and pCreator will be untouched if the process |
can't be found. |
pPSN input: The process whose info you want (nil for current). |
pProcessType output: The process's type. |
pCreator output: The process's signature. |
RESULT CODES |
____________ |
noErr 0 No error |
paramErr Ð50 Process serial number is invalid |
____________ |
*/ |
pascal OSStatus MoreProcGetProcessTypeSignature( |
const ProcessSerialNumberPtr pPSN, |
OSType *pProcessType, |
OSType *pCreator) |
{ |
OSStatus anErr = noErr; |
ProcessInfoRec infoRec; |
ProcessSerialNumber localPSN; |
infoRec.processInfoLength = sizeof(ProcessInfoRec); |
infoRec.processName = nil; |
infoRec.processAppSpec = nil; |
if ( pPSN == nil ) { |
localPSN.highLongOfPSN = 0; |
localPSN.lowLongOfPSN = kCurrentProcess; |
} else { |
localPSN = *pPSN; |
} |
anErr = GetProcessInformation(&localPSN, &infoRec); |
if (noErr == anErr) |
{ |
*pProcessType = infoRec.processType; |
*pCreator = infoRec.processSignature; |
} |
return anErr; |
}//end MoreProcGetProcessTypeSignature |
/****************************************************************************** |
Returns the FSSpec for the current process |
pFSSpec output: The process's FSSpec. |
RESULT CODES |
____________ |
noErr 0 No error |
paramErr Ð50 pFSSpec is nil |
____________ |
*/ |
pascal OSStatus MoreProcGetCurrentProcessFSSpec(FSSpec *pFSSpec) |
{ |
return MoreProcGetProcessAppFile(nil,pFSSpec); |
} |
/****************************************************************************** |
Returns the FSSpec for the process specified by ProcessSerialNumberPtr. |
pPSN input: The process's Serial Number |
if nil return the AppFile for the current process |
pAppFile output: The process's appFile. |
RESULT CODES |
____________ |
noErr 0 No error |
paramErr Ð50 Process serial number is invalid (or pPSN or pAppFile is nil) |
____________ |
*/ |
pascal OSStatus MoreProcGetProcessAppFile(const ProcessSerialNumber *pPSN,FSSpec *pAppFile) |
{ |
OSStatus anErr; |
ProcessInfoRec processInfo; |
ProcessSerialNumber localPSN; |
if (nil == pAppFile) |
return paramErr; |
if ( pPSN == nil ) { |
localPSN.highLongOfPSN = 0; |
localPSN.lowLongOfPSN = kCurrentProcess; |
} else { |
localPSN = *pPSN; |
} |
processInfo.processInfoLength = sizeof(processInfo); |
processInfo.processName = nil; |
processInfo.processAppSpec = pAppFile; |
anErr = GetProcessInformation(&localPSN, &processInfo); |
return anErr; |
} |
/****************************************************************************** |
Returns the Process Information for the process specified by pPSN. |
pPSN input: The process's Serial Number |
pPIR output: The process's Information. |
RESULT CODES |
____________ |
noErr 0 No error |
paramErr Ð50 Process serial number is invalid (or pPSN or pPIR is nil) |
____________ |
*/ |
pascal OSStatus MoreProcGetProcessInformation(const ProcessSerialNumber *pPSN,ProcessInfoRec *pPIR) |
{ |
if (!MoreAssert (pPIR)) |
return paramErr; |
pPIR->processInfoLength = sizeof (*pPIR); |
pPIR->processName = nil; |
pPIR->processAppSpec = nil; |
if (pPSN) |
return GetProcessInformation (pPSN,pPIR); |
else |
{ |
ProcessSerialNumber psn = { kNoProcess,kCurrentProcess }; |
return GetProcessInformation (&psn,pPIR); |
} |
} |
/****************************************************************************** |
Returns true if the process specified by pPSN is a background only application. |
pPSN input: The process's Serial Number |
pIsBOA output: The process's Information. |
RESULT CODES |
____________ |
noErr 0 No error |
paramErr Ð50 Process serial number is invalid (or pPSN or pIsBOA is nil) |
____________ |
*/ |
pascal OSStatus MoreProcIsProcessBackgroundOnly(const ProcessSerialNumber *pPSN,Boolean *pIsBOA) |
{ |
OSStatus anErr = noErr; |
ProcessInfoRec pir; |
if (!MoreAssert (pIsBOA)) |
return paramErr; |
if (!(anErr = MoreProcGetProcessInformation (pPSN,&pir))) |
{ |
*pIsBOA = (modeOnlyBackground & pir.processMode) ? true : false; |
} |
return anErr; |
} |
extern pascal Boolean MoreProcIsProcessAtFront(const ProcessSerialNumber *pPSN) |
// See comment in header. |
{ |
OSStatus anErr; |
ProcessSerialNumber localPSN; |
ProcessSerialNumber frontPSN; |
Boolean isSame; |
if ( pPSN == nil ) { |
localPSN.highLongOfPSN = 0; |
localPSN.lowLongOfPSN = kCurrentProcess; |
} else { |
localPSN = *pPSN; |
} |
anErr = GetFrontProcess(&frontPSN); |
if (noErr == anErr) { |
anErr = SameProcess(&localPSN, &frontPSN, &isSame); |
} |
MoreAssertQ(noErr == anErr); // If either of the previous return an error, we want to know why. |
return (noErr == anErr) && isSame; |
} |
Copyright © 2003 Apple Computer, Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2003-01-14