![]() |
CreateCompDescriptor |
||||
Header: | AEPackObject.h | Carbon status: | Supported | |
Creates a comparison descriptor record that specifies how to compare one or more Apple event objects with either another Apple event object or a descriptor record.
OSErr CreateCompDescriptor ( DescType comparisonOperator, AEDesc *operand1, AEDesc *operand2, Boolean disposeInputs, AEDesc *theDescriptor );
The comparison operator for comparing the descriptor records in the operand1 and operand2 parameters. The standard comparison operators are defined in
The actual comparison of the two operands is performed by the object comparison function provided by the client application. The way a comparison operator is interpreted is up to each application.
A pointer to an object specifier record.
A pointer to a descriptor record (which can be an object specifier record or any other descriptor record) whose value is compared to the value of operand1.
A Boolean value. Pass TRUE if the function should automatically dispose of any descriptor records you have provided in the operand1 and operand2 parameters to the function. Pass FALSE if your application will dispose of the records itself. 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 comparison descriptor record created by CreateCompDescriptor. Your application must dispose of this descriptor record after it has finished using it.
A result code.
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)