Provides a facility for compiling AEBuild descriptor strings into Apple event descriptors (
- macOS 10.0+
- Core Services
A pointer to a descriptor where the resulting descriptor should be stored. See
A pointer to an
AEBuildstructure where additional information about any errors that occur will be saved. This is an optional parameter and you can pass
NULLif this information is not required. See
AEBuildformat string describing the descriptor to be created.
A numeric result code indicating the success of the call. A value of
AEBuild (zero) means the call succeeded. You can use the
error parameter to discover information about other errors. See also Result Codes.
This function and related “AEBuild” routines provide a very simple translation service for converting specially formatted strings into complex Apple event descriptors. Normally, creating complex Apple event descriptors requires a large number of calls to Apple event Manager routines to build up the descriptor piece by piece. The
AEBuild function and related routines allow you to consolidate all of the calls required to construct a complex Apple event descriptor into a single system call that creates the desired structure as directed by a format string that you provide.
Prior to OS X version 10.3,
AEBuild would fail if you supplied a data parameter with size greater than 32767 bytes.