CFDataGetBytePtr |
||||
Header: | CFData.h | Carbon status: | Supported | |
Obtains a pointer to the bytes of a CFData object. The bytes cannot be modified.
const UInt8 *CFDataGetBytePtr ( CFDataRef data );
Pass a reference to the CFData object whose byte contents you wish to access.
A pointer to a read-only byte buffer.
This function either returns the requested pointer immediately, with no memory allocations and no copying, or it returns NULL. If the latter is the result, call the CFDataGetBytes function to copy the byte contents to an external buffer.
Whether the CFDataGetBytePtr function returns a valid pointer or NULL depends on many factors, all of which depend on how the object was created. In addition, the function result might change between different releases and on different platforms. So do not count on receiving a non-NULL result from this function under any circumstances.
Supported in Carbon. Available in Carbon 1.0.2 and later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)