ANNFILEINFO

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.