![]() |
CreateLogicalDescriptor |
||||
Header: | AEPackObject.h | Carbon status: | Supported | |
Creates a logical descriptor record that specifies a logical operator and one or more logical terms for the Apple Event Manager to evaluate.
OSErr CreateLogicalDescriptor ( AEDescList *theLogicalTerms, DescType theLogicOperator, Boolean disposeInputs, AEDesc *theDescriptor );
A pointer to a list containing comparison descriptor records (typeLogicalDescriptor), logical descriptor records (typeCompDescriptor), 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.
A logical operator represented by one of the constants described in
A Boolean value. Pass TRUE if the function should automatically dispose of the descriptor records you have provided in the theLogicalTerms parameter or (FALSE) if your application will. A value of FALSE may be more efficient for some applications because it allows them to reuse descriptor records.
A pointer to a descriptor record. On successful return, the logical descriptor record created by CreateLogicalDescriptor. Your application must dispose of this descriptor record after it has finished using it.
A result code.
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.
Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.
© 2000 Apple Computer, Inc. (Last Updated 5/8/2000)