Closes and deallocates an
- macOS 10.0+
- Core Services
A result code. See Result Codes.
Use this function to dispose of an
AEStream you created using
AEStream. To retrieve the resulting descriptor from the stream prior to disposal, pass in a pointer to an
AEDesc structure in the
desc parameter. If this parameter exists,
AEStream fills in the descriptor with the stream data. If the stream contains invalid information, possibly due to improperly balanced calls to “AEStream” functions, the returned descriptor type is set to
Regardless of any errors returned by this function, it is always safe to call
AEDispose on the returned descriptor.
NULL for the
desc parameter causes
AEStream to discard the stream data and dispose of the
AEStream. When you call
AEStream in this way, you do not need to worry about balancing nested calls to “AEStream” functions. This technique is particularly useful during error-handling situations where you need to dispose of a stream but do not know its exact state.