ANNFILEINFO

Show in webframe

typedef struct tagANNFILEINFO
{
   L_UINT uStructSize;
   L_SSIZE_T nOffset;
   L_INT32 nVersion;
   L_UINT uFormat;
   L_INT32 nTotalPages;
   L_INT32 nReserved;
} ANNFILEINFO, * pANNFILEINFO;

The ANNFILEINFO structure contains information retrieved from a LEAD annotation file.

Member	Description
uStructSize	Size of the structure. This must be set before passing this structure to the LEAD functions.
nOffset	Position of the first byte to load. This must be set before passing this structure to the LEAD functions. Typically, this is set to 0.
nVersion	Version of the annotation file. If '12' is returned, this refers to version 12 or earlier.
uFormat	Flag that indicates the format of the annotation data in the file. Possible values are:
	Value	Meaning
	ANNFMT_EMF	Windows EMF format.
	ANNFMT_ENCODED	LEAD binary format. This file size is smaller and is upward compatible. It also provides better security.
	ANNFMT_NATIVE	LEAD text-based format for annotations.
	ANNFMT_WMF	Windows WMF format.
	ANNFMT_XML	XML text format. This is LEAD©s new text-based format which is upward-compatible.
nTotalPages	The total number of pages in the annotation file.
nReserved	Reserved for future use. Pass 0.

Comments

The ANNFILEINFO structure is updated by the L_AnnFileInfo, L_AnnFileInfoMemory and L_AnnFileInfoOffset functions with information about an annotation file. Before passing this structure to any of the LEAD functions, the nSize and nOffset fields must be filled.

Some functions which take this structure as a parameter require that the structure be initialized prior to the function call. You must set the uStructSize member to the total size, in bytes, of the structure. Use the sizeof() macro to calculate this value. Functions that do not require the structure be initialized will take the total size of the structure, in bytes, as an additional function parameter.