MoreAppleEvents.h

/*
    File:       MoreAppleEvents.h
 
    Contains:   Apple Event 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: MoreAppleEvents.h,v $
Revision 1.16  2002/03/07 20:32:14  geowar
General clean up.
Added recovery code to MoreAESendEventReturnPString.
New API: MoreAECreateAEDescFromCFString.
 
Revision 1.15  2002/02/19 18:55:16  geowar
Written by: => DRI:
 
Revision 1.14  2002/01/16 19:11:56  geowar
Added MoreAESendEventReturnAEDesc, MoreAESendEventReturnAEDescList,
MoreAETellSelfToSetCFStringRefProperty,  & MoreAEGetCFStringFromDescriptor routines.
 
Revision 1.13  2001/11/07 15:50:54  eskimo1
Tidy up headers, add CVS logs, update copyright.
 
 
        <12>     21/9/01    Quinn   Changes for CWPro7 Mach-O build.
        <11>     8/28/01    gaw     CodeBert (error -> pError, theAppleEvent -> pAppleEvent, etc.)
        <10>     15/2/01    Quinn   MoreAECreateAppleEventTargetID is not supported for Carbon
                                    builds because all of its required declarations are defined
                                    CALL_NOT_IN_CARBON.
         <9>     27/3/00    Quinn   Remove MoreAEDeleteItemFromRecord.  It's functionality is
                                    covered by AEDeleteKeyDesc.
         <8>     20/3/00    Quinn   Added routines to deal with "missing value".  Added
                                    MoreAECopyDescriptorDataToHandle.  Fixed some copy and paste
                                    errors in the comments.
         <7>      3/9/00    GW      Intergrating AppleEvent Helper code
         <6>      6/3/00    Quinn   Added a bunch of trivial wrapper routines.  George may come
                                    along and change all these soon, but I needed them for MoreOSL.
         <5>      1/3/00    Quinn   Change the signature for AEGetDescData to match the version we
                                    actually shipped.
         <4>     2/15/99    PCG     add AEGetDescDataSize for non-Carbon clients
         <3>     1/29/99    PCG     add AEGetDescData
         <2>    11/11/98    PCG     fix headers
         <1>    11/10/98    PCG     first big re-org at behest of Quinn
 
    Old Change History (most recent first):
 
         <4>    10/11/98    Quinn   Convert "MorePrefix.h" to "MoreSetup.h".
         <3>      9/9/98    PCG     re-work import and export pragmas
         <2>     7/24/98    PCG     coddle linker (C++, CFM-68K)
         <1>     6/16/98    PCG     initial checkin
*/
 
#pragma once
 
//********************************************************************************
//  A private conditionals file to setup the build environment for this project.
#include "MoreSetup.h"
 
#if ! MORE_FRAMEWORK_INCLUDES
    //********************************************************************************
    //  System includes
    #include <AERegistry.h>
    #include <AEObjects.h>
    #include <AEPackObject.h>
    #include <EPPC.h>
    #include <Gestalt.h>
    #include <Processes.h>
#endif
 
//********************************************************************************
#define kFlagNotSet -1
//********************************************************************************
#ifdef __cplusplus
    extern "C" {
#endif
/********************************************************************************
    Create and return an AEDesc for the process target with the specified PSN.
    If no PSN is supplied the use the current process
 
    pAEEventClass   ==> The class of the event to be created.
    pAEEventID      ==> The ID of the event to be created.
    pAppleEvent     ==> Pointer to an AppleEvent where the
                        event record will be returned.
                    <== The Apple event.
    
    RESULT CODES
    ____________
    noErr              0    No error    
    memFullErr      -108    Not enough room in heap zone    
    ____________
*/
extern pascal OSErr MoreAECreateProcessTarget (ProcessSerialNumber* pPSN,AEDesc* target);
/********************************************************************************
    Create and return an AppleEvent of the given class and ID. The event will be
    targeted at the current process, with an AEAddressDesc of type
    typeProcessSerialNumber.
 
    pAEEventClass   ==> The class of the event to be created.
    pAEEventID      ==> The ID of the event to be created.
    pAppleEvent     ==> Pointer to an AppleEvent where the
                        event record will be returned.
                    <== The Apple event.
    
    RESULT CODES
    ____________
    noErr              0    No error    
    memFullErr      -108    Not enough room in heap zone    
    ____________
*/
extern pascal OSErr MoreAECreateAppleEventSelfTarget( AEEventClass pAEEventClass,
                              AEEventID pAEEventID,
                              AppleEvent* pAppleEvent );
/********************************************************************************
    Create and return an AppleEvent of the given class and ID. The event will be
    targeted at the process specified by the target type and creator codes, 
    with an AEAddressDesc of type typeProcessSerialNumber.
 
    pType           ==> The file type of the process to be found.
    pCreator        ==> The creator type of the process to be found.
    pAEEventClass   ==> The class of the event to be created.
    pAEEventID      ==> The ID of the event to be created.
    pAppleEvent     ==> Pointer to an AppleEvent where the
                        event record will be returned.
                    <== The Apple event.
    
    RESULT CODES
    ____________
    noErr              0    No error    
    memFullErr      -108    Not enough room in heap zone    
    procNotFound    Ð600    No eligible process with specified descriptor
    ____________
*/
extern pascal OSErr MoreAECreateAppleEventSignatureTarget( OSType pType,
                                             OSType pCreator,
                                             AEEventClass pAEEventClass,
                                             AEEventID pAEEventID,
                                             AppleEvent* pAppleEvent );
/********************************************************************************
    Create and return an AppleEvent of the given class and ID. The event will be
    targeted at the application with the specific creator.
 
    psnPtr          ==> Pointer to the PSN to target the event with.
    pAEEventClass   ==> The class of the event to be created.
    pAEEventID      ==> The ID of the event to be created.
    pAppleEvent     ==> Pointer to an AppleEvent where the
                        event record will be returned.
                    <== The Apple event.
    
    RESULT CODES
    ____________
    noErr              0    No error    
    memFullErr      -108    Not enough room in heap zone    
    procNotFound    Ð600    No eligible process with specified descriptor
    ____________
*/
extern pascal OSStatus MoreAECreateAppleEventCreatorTarget(
                            const AEEventClass pAEEventClass,
                            const AEEventID pAEEventID,
                            const OSType pCreator,
                            AppleEvent* pAppleEvent);
/********************************************************************************
    Create and return an AppleEvent of the given class and ID. The event will be
    targeted with the provided PSN.
 
    psnPtr          ==> Pointer to the PSN to target the event with.
    pAEEventClass   ==> The class of the event to be created.
    pAEEventID      ==> The ID of the event to be created.
    pAppleEvent     ==> Pointer to an AppleEvent where the
                        event record will be returned.
                    <== The Apple event.
    
    RESULT CODES
    ____________
    noErr              0    No error    
    memFullErr      -108    Not enough room in heap zone    
    procNotFound    Ð600    No eligible process with specified descriptor
    ____________
*/
extern pascal OSErr MoreAECreateAppleEventProcessTarget( const ProcessSerialNumberPtr psnPtr,
                                           AEEventClass pAEEventClass,
                                           AEEventID pAEEventID,
                                           AppleEvent* pAppleEvent );
/********************************************************************************
    Create and return an AppleEvent of the given class and ID. The event will be
    targeted with the provided TargetID.
 
    pTargetID       ==> Pointer to the TargetID to target the event with.
    pAEEventClass   ==> The class of the event to be created.
    pAEEventID      ==> The ID of the event to be created.
    pAppleEvent     ==> Pointer to an AppleEvent where the
                        event record will be returned.
                    <== The Apple event.
    
    RESULT CODES
    ____________
    noErr              0    No error    
    memFullErr      -108    Not enough room in heap zone    
    procNotFound    Ð600    No eligible process with specified descriptor
    ____________
*/
 
#if CALL_NOT_IN_CARBON
 
//********************************************************************************
// Addressing Apple events by target has been deprecated in Carbon, 
// so much so that constants like typeTargetID are not available to 
// Carbon applications.  So we canÕt support this routine for Carbon 
// development.
 
extern pascal OSErr MoreAECreateAppleEventTargetID( const TargetID* pTargetID,
                                      AEEventClass pAEEventClass,
                                      AEEventID pAEEventID,
                                      AppleEvent* pAppleEvent );
 
#endif
 
/********************************************************************************
    Send the provided AppleEvent using the provided idle function.
    Will wait for a reply if an idle function is provided, but no result will be returned.
 
    pIdleProcUPP    ==> The idle function to use when sending the event.
    pAppleEvent     ==> The event to be sent.
    
    RESULT CODES
    ____________
    noErr              0    No error    
    
    and any other error that can be returned by AESend or the handler
    in the application that gets the event.
    ____________
*/
extern pascal OSErr MoreAESendEventNoReturnValue( const AEIdleUPP pIdleProcUPP,
                                           const AppleEvent* pAppleEvent );
/********************************************************************************
    Send the provided AppleEvent using the provided idle function.
    Return the direct object as a AEDesc of pAEDescType
 
    pIdleProcUPP    ==> The idle function to use when sending the event.
    pAppleEvent     ==> The event to be sent.
    pDescType       ==> The type of value returned by the event.
    pAEDescList     <== The value returned by the event.
 
    RESULT CODES
    ____________
    noErr              0    No error    
    paramErr         -50    No idle function provided
 
    and any other error that can be returned by AESend or the handler
    in the application that gets the event.
    ____________
*/
extern pascal OSErr MoreAESendEventReturnAEDesc(
                        const AEIdleUPP     pIdleProcUPP,
                        const AppleEvent    *pAppleEvent,
                        const DescType      pDescType,
                        AEDesc              *pAEDesc);
/********************************************************************************
    Send the provided AppleEvent using the provided idle function.
    Return the direct object as a AEDescList
 
    pIdleProcUPP    ==> The idle function to use when sending the event.
    pAppleEvent     ==> The event to be sent.
    pAEDescList     <== The value returned by the event.
 
    RESULT CODES
    ____________
    noErr              0    No error    
    paramErr         -50    No idle function provided
 
    and any other error that can be returned by AESend or the handler
    in the application that gets the event.
    ____________
*/
extern pascal OSErr MoreAESendEventReturnAEDescList(
                        const AEIdleUPP     pIdleProcUPP,
                        const AppleEvent    *pAppleEvent,
                        AEDescList          *pAEDescList);
/********************************************************************************
    Send the provided AppleEvent using the provided idle function.
    Return data (at pDataPtr) of type pDesiredType
 
    pIdleProcUPP    ==> The idle function to use when sending the event.
    pAppleEvent     ==> The event to be sent.
    theValue        <== The value returned by the event.
 
    RESULT CODES
    ____________
    noErr              0    No error    
    paramErr         -50    No idle function provided
 
    and any other error that can be returned by AESend or the handler
    in the application that gets the event.
    ____________
*/
extern pascal OSErr MoreAESendEventReturnData(
                        const AEIdleUPP     pIdleProcUPP,
                        const AppleEvent    *pAppleEvent,
                        DescType            pDesiredType,
                        DescType*           pActualType,
                        void*               pDataPtr,
                        Size                pMaximumSize,
                        Size                *pActualSize);
/********************************************************************************
    Send the provided AppleEvent using the provided idle function.
    Return a SInt16 (typeSmallInteger).
 
    pIdleProcUPP    ==> The idle function to use when sending the event.
    pAppleEvent     ==> The event to be sent.
    theValue        <== The value returned by the event.
    
    RESULT CODES
    ____________
    noErr              0    No error    
    paramErr         -50    No idle function provided
    
    and any other error that can be returned by AESend or the handler
    in the application that gets the event.
    ____________
*/
extern pascal OSErr MoreAESendEventReturnSInt16(
                    const AEIdleUPP pIdleProcUPP,
                    const AppleEvent* pAppleEvent,
                    SInt16* theValue );
/********************************************************************************
    Send the provided AppleEvent using the provided idle function.
    Returns a PString.
 
    pIdleProcUPP    ==> The idle function to use when sending the event.
    pAppleEvent     ==> The event to be sent.
    pStr255         <== The value returned by the event.
 
    RESULT CODES
    ____________
    noErr              0    No error    
    paramErr         -50    No idle function provided
 
    and any other error that can be returned by AESend or the handler
    in the application that gets the event.
    ____________
*/
extern pascal OSErr MoreAESendEventReturnPString(
                        const AEIdleUPP pIdleProcUPP,
                        const AppleEvent* pAppleEvent,
                        Str255 pStr255);
/********************************************************************************
    Send an AppleEvent of the specified Class & ID to myself using the 
    provided idle function.  The actual target of the event is the
    pSelection property of the application.
 
    pEventID        ==> The event to be sent.
 
    RESULT CODES
    ____________
    noErr              0    No error    
 
    and any other error that can be returned by AESend or the handler
    in the application that gets the event.
    ____________
*/
extern pascal OSErr MoreAESendToSelfNoReturnValue(
                const AEEventClass pEventClass,
                const AEEventID pEventID);
/********************************************************************************
    Send an AppleEvent of the specified Class & ID to myself using the 
    provided idle function. Wait for a reply and extract a SInt16 result.
    The actual target of the event is the pSelection property of the 
    application.
 
    pEventID        ==> The event to be sent.
    pValue          <== Where the return SInt16 will be stored.
 
    RESULT CODES
    ____________
    noErr              0    No error    
 
    and any other error that can be returned by AESend or the handler
    in the application that gets the event.
    ____________
*/
extern pascal OSErr MoreAESendToSelfReturnSInt16(
                const AEEventClass pEventClass,
                const AEEventID pEventID,
                SInt16* pValue);
/********************************************************************************
    Send a get data (kAEGetData) AppleEvent to myself using the 
    provided idle function. Wait for a reply and extract a SInt16 result.
    
    pEventID        ==> The event to be sent.
    pValue          <== Where the resulting SInt16 will be stored.
 
    RESULT CODES
    ____________
    noErr              0    No error    
 
    and any other error that can be returned by AESend or the handler
    in the application that gets the event.
    ____________
*/
extern pascal OSErr MoreAETellSelfToGetSInt16Property(
                const DescType pPropType,
                SInt16* pValue);
/********************************************************************************
    Send a get data (kAEGetData) AppleEvent to myself using the 
    provided idle function. Wait for a reply and extract a Str255 result.
    The actual target of the event is the pSelection property of the 
    application.
 
    pEventID        ==> The event to be sent.
    pValue          <== Where the resulting Str255 will be stored.
 
    RESULT CODES
    ____________
    noErr              0    No error    
 
    and any other error that can be returned by AESend or the handler
    in the application that gets the event.
    ____________
*/
extern pascal OSErr MoreAETellSelfToGetStr255Property(
                const DescType pPropType,
                Str255 pValue);
/********************************************************************************
    Send a set data (kAESetData) AppleEvent to myself with a SInt16 parameter
    and using the provided idle function.
 
    pEventID        ==> The event to be sent.
    pValue          <== Where the resulting SInt16 will be stored.
 
    RESULT CODES
    ____________
    noErr              0    No error    
 
    and any other error that can be returned by AESend or the handler
    in the application that gets the event.
    ____________
*/
extern pascal OSErr MoreAETellSelfToSetSInt16Property(
                const DescType pPropType,
                SInt16 pValue);
/********************************************************************************
    Send a set data (kAESetData) AppleEvent to myself with a Pascal string
    parameter and using the default idle function.
 
    pEventID        ==> The event to be sent.
    pValue          ==> The Str255 to be sent.
 
    RESULT CODES
    ____________
    noErr              0    No error    
 
    and any other error that can be returned by AESend or the handler
    in the application that gets the event.
    ____________
*/
extern pascal OSErr MoreAETellSelfToSetStr255Property(
                const DescType pPropType,
                Str255 pValue);
/********************************************************************************
    Send a set data (kAESetData) AppleEvent to myself with a CFStringRef
    parameter and using the default idle function.
 
    pEventID        ==> The event to be sent.
    pValue          ==> The CFString to be sent.
 
    RESULT CODES
    ____________
    noErr              0    No error    
 
    and any other error that can be returned by AESend or the handler
    in the application that gets the event.
    ____________
*/
extern pascal OSErr MoreAETellSelfToSetCFStringRefProperty(
                const DescType pPropType,
                const CFStringRef pCFStringRef);
 
//*******************************************************************************
// Appends each of the items in pSourceList to the pDestList.
extern pascal OSStatus MoreAEAppendListToList(const AEDescList* pSourceList,AEDescList* pDestList);
 
//*******************************************************************************
// This routine takes a result descriptor and an error.
// If there is a result to add to the reply it makes sure the reply isn't
// NULL itself then adds the error to the reply depending on the error
// and the type of result.
extern pascal OSErr MoreAEMoreAESetReplyErrorNumber (OSErr pOSErr,AppleEvent* pAEReply);
//*******************************************************************************
// This routine takes a result descriptor, a reply descriptor and an error.
// If there is a result to add to the reply it makes sure the reply isn't
// NULL itself then adds the result to the reply depending on the error
// and the type of result.
extern pascal OSErr MoreAEAddResultToReply(const AEDesc* pResult,AEDesc* pAEReply,const OSErr pError);
// ----------------------------------------------------------------------
//  Name:       MoreAEGotRequiredParams
//  Function:   Checks that all parameters defined as 'required' have been read
// ----------------------------------------------------------------------
extern pascal OSErr MoreAEGotRequiredParams(const AppleEvent* pAppleEventPtr);
/********************************************************************************
    Takes a reply event checks it for any errors that may have been returned
    by the event handler. A simple function, in that it only returns the error
    number. You can often also extract an error string and three other error
    parameters from a reply event.
    
    Also see:
        IM:IAC for details about returned error strings.
        AppleScript developer release notes for info on the other error parameters.
    
    pAEReply        ==> The reply event to be checked.
 
    RESULT CODES
    ____________
    noErr                   0   No error    
    ????                    ??  Pretty much any error, depending on what the
                                event handler returns for it's errors.
*/
extern pascal OSErr MoreAEGetHandlerError( const AppleEvent* pAEReply );
/********************************************************************************
    Get the class and ID from an AppleEvent.
 
    pAppleEvent     ==> The event to get the class and ID from.
    pAEEventClass   <== The event's class.
    pAEEventID      <== The event's ID.
    
    RESULT CODES
    ____________
    noErr                       0   No error    
    memFullErr               -108   Not enough room in heap zone    
    errAEDescNotFound       -1701   Descriptor record was not found 
    errAENotAEDesc          -1704   Not a valid descriptor record   
    errAEReplyNotArrived    -1718   Reply has not yet arrived   
*/  
extern pascal OSErr MoreAEExtractClassAndID ( const AppleEvent* pAppleEvent,
                             AEEventClass* pAEEventClass,
                             AEEventID* pAEEventID );
/********************************************************************************
    A very simple idle function. It simply ignors any event it receives,
    returns 30 for the sleep time and nil for the mouse region.
    
    Your application should supply an idle function that handles any events it
    might receive. This is especially important if your application has any windows.
    
    Also see:
        IM:IAC for details about idle functions.
        Pending Update Perils technote for more about handling low-level events.
*/  
extern pascal Boolean   MoreAESimpleIdleFunction( EventRecord* event,
                                       long* sleepTime,
                                       RgnHandle* mouseRgn );
/********************************************************************************
    Is the Apple Event Manager present.
    
    RESULT CODES
    ____________
    true    The Apple Event Manager is present
    false   It isn't
*/
extern pascal Boolean   MoreAEHasAppleEvents(void);
//*******************************************************************************
// Did this AppleEvent come from the Finder?
extern pascal OSErr MoreAEIsSenderFinder (const AppleEvent* pAppleEvent,Boolean* pIsFinder);
 
//*******************************************************************************
// Initialises desc to the null descriptor (typeNull,nil).
extern pascal void MoreAENullDesc(AEDesc* desc);
//*******************************************************************************
// Disposes of desc and initialises it to the null descriptor.
extern pascal void MoreAEDisposeDesc(AEDesc* desc);
//*******************************************************************************
// These routines are only implemented in PreCarbon.o for PowerPC
// So for 68K we had to write our own versions
#if TARGET_CPU_68K || !ACCESSOR_CALLS_ARE_FUNCTIONS
extern pascal Size AEGetDescDataSize( const AEDesc* pAEDesc);
extern pascal OSErr AEGetDescData(
                    const AEDesc*   pAEDesc,
                    void*           pDataPtr,
                    Size            pMaxSize);
#endif TARGET_CPU_68K || !ACCESSOR_CALLS_ARE_FUNCTIONS
/********************************************************************************
    These are generic routines that are used to extract data of
    different types from descriptor records.
 
    pAEDesc         ==> The descriptor we want the data from
    pDestPtr        <== Where we want to store the data from this desc.
    pMaxSize        ==> The maxium amount of data we can store.
    pActualSize     <== The actual amount of data stored.
 
    RESULT CODES
    ____________
    noErr              0    No error    
    ____________
*/
extern pascal void MoreAEGetRawDataFromDescriptor(const AEDesc* pAEDesc,
                             Ptr    pDestPtr,
                             Size   pMaxSize,
                             Size*  pActualSize);
extern pascal OSErr MoreAEGetCFStringFromDescriptor(const AEDesc* pAEDesc,CFStringRef* pCFStringRef);
extern pascal OSErr MoreAEGetPStringFromDescriptor(const AEDesc* pAEDesc,StringPtr pStringPtr);
extern pascal OSErr MoreAEGetCStringFromDescriptor(const AEDesc* pAEDesc,char* pCharPtr);
extern pascal OSErr MoreAEGetShortFromDescriptor(const AEDesc* pAEDesc,SInt16* pResult);
extern pascal OSErr MoreAEGetBooleanFromDescriptor(const AEDesc* pAEDesc,Boolean* pResult);
extern pascal OSErr MoreAEGetLongFromDescriptor(const AEDesc* pAEDesc,long* pResult);
extern pascal OSErr MoreAEGetOSTypeFromDescriptor(const AEDesc* pAEDesc,OSType* pResult);
 
/********************************************************************************
    Creates an AEDesc from a CFString.
 
  pCFStringRef  ==> The CFString we want the data from
  pAEDesc       <== Where we want to store the AEDesc
 
  RESULT CODES
  ____________
  noErr            0    No error    
  ____________
*/
extern pascal OSErr MoreAECreateAEDescFromCFString(const CFStringRef pCFStringRef,AEDesc* pAEDesc);
 
//*******************************************************************************
// This routine creates a new handle and puts the contents of the desc
// in that handle.  CarbonÕs opaque AEDescÕs means that we need this
// functionality a lot.
 
extern pascal OSStatus MoreAECopyDescriptorDataToHandle(const AEDesc* desc,Handle* descData);
 
//*******************************************************************************
// This routine returns true if and only if desc is the "missing value" value.
 
extern pascal Boolean MoreAEIsMissingValue(const AEDesc* desc);
 
//*******************************************************************************
// This routine creates a descriptor that represents the missing value.
 
extern pascal OSStatus MoreAECreateMissingValue(AEDesc* desc);
 
#ifdef __cplusplus
}
#endif