PxIOGetDictionaryInfo |
|
Returns file dictionary information, such as embedded IOL, from the specified keyed file
int PxIOGetDictionaryInfo(PxIOFileHandle handle, char *buffer, size_t *bufferSize, PxIODictionaryInfoType dictionaryInfo);
Where:
handle |
The handle of an open keyed file | ||||||||
buffer |
A pointer to a buffer into which to return the dictionary information | ||||||||
bufferSize |
A pointer to a size_t variable. When the function is called, this variable should contain the size of the buffer field and should take into account a terminating NULL character at the end of the dictionary to be returned. Upon return, this value will contain the size of the retrieved information. If the function has failed because the buffer field is not large enough or because buffer is NULL, it will contain the required size of the buffer field. | ||||||||
dictionaryInfo |
The embedded information requested. The available options are:
|
If the function succeeds, a value of PXIO_SUCCESS_STATUS is returned; otherwise, an error value is returned. More information on the nature of the error can be found by calling PxIOGetError.