Creates an empty descriptor list or Apple event record.
- macOS 10.0+
- Core Services
A pointer to the data at the beginning of each descriptor that is the same for all descriptors in the list. If there is no common data, or if you decide not to isolate the common data, pass
NULLas the value of this parameter.
The size of the common data. If there is no common data, or if you decide not to isolate the common data, pass 0 as the value of this parameter. (See the Discussion section for more information.)
A Boolean value that specifies the kind of list to create. Pass a value of
TRUEto create an Apple event record (a data structure of type
FALSEto create a descriptor list.
A pointer to a descriptor list variable. On successful return, the descriptor list or Apple event record that the
AECreatefunction creates. On error, a null descriptor. See
A result code. See Result Codes.
AECreate function creates an empty descriptor list or Apple event record. You can use the functions described in “Adding Items to Descriptor Lists” to populate the list as part of creating an Apple event. After sending the Apple event with the AESend(_:_:_:_:_:_:_:) function, you should dispose of the descriptor list with the
AEDispose function when you no longer need it.
If you intend to use a descriptor list for a factored Apple event array, you must provide, in the
factoring parameter, a pointer to the data shared by all items in the array and, in the
factored parameter, the size of the common data. The common data must be 4, 8, or more than 8 bytes in length because it always consists of (a) the descriptor type (4 bytes) (b) the descriptor type (4 bytes) and the size of each item’s data (4 bytes) or (c) the descriptor type (4 bytes), the size of each item’s data (4 bytes), and some portion of the data itself (1 or more bytes).
For information about data types used with Apple event arrays, see Data Types.
factored parameters are not supported in macOS 10.2 and later. You should pass
NULL and zero, respectively, for these parameters.
Thread safe starting in OS X v10.2.