17 Managing Unknown Objects
Q3UnknownBinary_GetData
function to get the data of an unknown binary object.
TQ3Status Q3UnknownBinary_GetData ( TQ3UnknownObject unknownObject, TQ3UnknownBinaryData *unknownBinaryData);unknownObject
An unknown binary object.unknownBinaryData
A pointer to an unknown binary data structure.
Q3UnknownBinary_GetData
function returns, in the contents
field of the unknown binary data structure pointed to by the unknownBinaryData
parameter, a pointer to a copy of the contents of the unknown binary object (that is, an unknown object of type kQ3UnknownTypeBinary
) specified by the unknownObject
parameter. Q3UnknownBinary_GetData
also returns, in the objectType
and size
fields of the unknown binary data structure, the type of the unknown binary object and the size, in bytes, of the data pointed to by the contents
field.
Your application is responsible for allocating the memory occupied by the unknownBinaryData
parameter. Q3UnknownBinary_GetData
allocates memory to hold the data pointed to by the contents
field of that structure. You must make certain to call Q3UnknownBinary_EmptyData
to release the memory allocated by Q3UnknownBinary_GetData
when you are finished using the data.
Let us know what you think of these prototype pages.
Generated with Harlequin WebMaker