Creates a new descriptor that incorporates the specified data.
- macOS 10.0+
- Core Services
A pointer to the data for the new descriptor. This data is copied into a newly-allocated block of memory for the descriptor that is created. To minimize copying overhead, consider using
Desc From External Ptr
The length, in bytes, of the data for the new descriptor.
A pointer to a descriptor. On successful return, a descriptor that incorporates the data specified by the
dataparameter. On error, a null descriptor. If the function returns successfully, your application should call the
AEDisposefunction to dispose of the resulting descriptor after it has finished using it. See
A result code. See Result Codes.
While it is possible to create an Apple event descriptor or a descriptor list or a descriptor with the
AECreate function (assuming you have access to the raw data for an Apple event, list, or descriptor), you typically create these structured objects with their specific creation routines—
Thread safe starting in OS X v10.2.