L_TCHAR * pszFile;

/* input file name */

L_UINT uFlags;

/* control flags */

L_UINT * puTagCount ;

/* number of geo keys found */

pLEADFILETAG* ppTags;

/* array geo key data */

L_SIZE_T* puDataSize;

/* the overall size of the geo keys data */

L_UCHAR** ppData;

/* the overall geo keys data */

pLOADFILEOPTION pLoadOptions;

/* pointer to optional extended load options */

Parameter

Description

pszFile

Character string that contains the input file name.

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 geo key overall data.

puTagCount

Address of the variable to be updated with the number of geo keys found in the file.

ppTags

Pointer to an array of pLEADEADFILETAG structures. Each element of the array contains data for one geo key field found in the file. The number of elements in ppGeoKeys is puGeoKeyCount. When this array is no longer needed pass it to the L_FreeFileTags function to free the allocated memory.

puDataSize

Address of the variable to be updated with the size in bytes of the overall geo key fields data.

ppData

Address of the variable to be updated with a pointer to the overall geo key fields data. The size of this pointer in bytes is puDataSize. Each LEADEADFILETAG 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.

SUCCESS

The function was successful

< 1

An error occurred. Refer to Return Codes.

LTFIL

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

Functions:

L_SetGeoKey, L_GetGeoKey, L_ReadFileGeoKey, L_FreeFileTags

Topics:

Implementing TIFF Comments and Tags

Implementing GeoKeys (GeoTIFF tags)