Retrieves a specified series of bytes from the specified descriptor.
- macOS 10.2+
- Core Services
A pointer to the descriptor to get the data from. See
A pointer to a buffer, local variable, or other storage location created and disposed of by your application. The size in bytes should be at least as large as the value you pass in the
lengthparameter. On return, contains the specified data from the descriptor.
The zero-based offset to the data to be retrieved from the descriptor.
The number of bytes of contiguous data to retrieve.
A result code. If the requested
length are such that they do not fit entirely within the descriptor’s data,
err. See also Result Codes.
This function is valid only for value type descriptors (such as
type). You can use this function when you know the precise location of a subset of data within the descriptor. For example, if the descriptor contains a block of your private data, you might retrieve just a particular chunk you need at a known offset, representing an image, a string, or some other data type. Or if a descriptor contains an RGB color, you can access just the blue field.
When used in conjunction with
AEGet can provide greatly improved performance, especially when working with large blocks of data.