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

noErr	0	No error occurred
paramErr	-50	Error in parameter list
memFullErr	-108	Not enough room in heap zone
errAECoercionFail	-1700	Data could not be coerced to requested Apple event data type
errAEWrongDataType	-1703	Wrong Apple event data type
errAENotAEDesc	-1704	Not a valid descriptor record
errAEBadListItem	-1705	Operation 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.