#include "ltwrappr.h"

L_INT LFile::ReadComments(uFlags, puCommentCount, ppComments, puDataSize, ppData, pLoadOptions)

L_UINT uFlags;

control flags

L_UINT * puCommentCount;

address of the variable to be updated with the number of comments found


address of the variable for comment data

L_SIZE_T * puDataSize;

address of the variable to be updated with the overall size of the comment data

L_UCHAR ** ppData;

address of the variable to be updated with the overall comment data


pointer to optional extended load options

Gets all the comment fields stored in a file.

Parameter Description
uFlags Flag that determines whether to read the tag overall data. You can combine values when appropriate by using a bitwise OR ( | ):
  Flag Meaning
  READFILEMETADATA_NOMEMORY [0x01] Do not read the tag overall data. If this flag is set, then puDataSize and ppData will not be used and the function will not read the comment overall data.
puCommentCount Address of the variable to be updated with the number of comments found in the file.
ppComments Pointer to an array of LEADFILECOMMENT structures. Each element of the array contains data for one comment field found in the file. The number of elements in ppComments is puCommentCount. When this array is no longer needed pass it to the LFile::FreeComments function to free the allocated memory.
puDataSize Address of the variable to be updated with the size in bytes of the overall comment field's data.
ppData Address of the variable to be updated with a pointer to the overall comment fields data. The size of this pointer in bytes is puDataSize. Each LEADFILECOMMENT item found contains an offset to where the data for this item is stored in ppData.
pLoadOptions Pointer to optional extended load options. Pass NULL to use the default load options.



The function was successful

< 0

An error occurred. Refer to Return Codes.


You must free the data allocated with this function using the LFile::FreeComments function.

If an error occurred in reading all file comments, then no comments will be returned, and the user is responsible to find the valid metadata in the file.

For general information about TIFF tags, refer to Implementing TIFF Comments and Tags.

Required DLLs and Libraries

File format DLLs

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.


Win32, x64.

See Also


LFile::ReadComment, Class Members


Raster Image Functions: Maintaining File Comments


Implementing TIFF Comments and Tags


Loading and Saving Images

<span c

For an example, refer to LFile::ReadTags.lass="deprecated-leadlabel-id">Example

Help Version 21.0.2020.8.25
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C++ Class Library Help