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: Interapplication Communication /
Chapter 6 - Resolving and Creating Object Specifier Records / Reference to Resolving and Creating Object Specifier Records
Routines for Resolving and Creating Object Specifier Records / Creating Object Specifier Records


CreateLogicalDescriptor

You can use the CreateLogicalDescriptor function to create a logical descriptor record.

FUNCTION CreateLogicalDescriptor 
                              (VAR theLogicalTerms: AEDescList; 
                               theLogicOperator: DescType; 
                               disposeInputs: Boolean; 
                               VAR theDescriptor: AEDesc): OSErr;
theLogicalTerms
A list containing comparison descriptor records, logical descriptor records, or both. If the value of the parameter theLogicOperator is kAEAND or kAEOR, the list can contain any number of descriptors. If the value of the parameter theLogicOperator is kAENOT, logically this list should contain a single descriptor record. However, the function will not return an error if the list contains more than one descriptor record for a logical operator of kAENOT.
theLogicOperator
A logical operator represented by one of the following constants:
            CONST    kAEAND = 'AND ';
                     kAEOR  = 'OR  ';
                     kAENOT = 'NOT ';
disposeInputs
A Boolean value indicating whether the function (TRUE) or your application (FALSE) should dispose of the descriptor records in the other parameters.
theDescriptor
The logical descriptor record created by CreateLogicalDescriptor.
DESCRIPTION
The CreateLogicalDescriptor function creates a logical descriptor record, which specifies a logical operator and one or more logical terms for the Apple Event Manager to evaluate.

RESULT CODES
noErr0No error occurred
paramErr-50Error in parameter list
memFullErr-108Not enough room in heap zone
errAECoercionFail-1700Data could not be coerced to requested Apple event data type
errAEWrongDataType-1703Wrong Apple event data type
errAENotAEDesc-1704Not a valid descriptor record
errAEBadListItem-1705Operation involving a list item failed
SEE ALSO
For an example of how to use the CreateLogicalDescriptor function to create a logical descriptor record, see "Specifying a Test," which begins on page 6-75.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996