EPNALPHATAGDATA

typedef struct tag_EPNALPHATAGDATA
{
   L_UINT uStructSize; 
   L_BOOL bUseMask; 
   L_INT nCharactersCount; 
   L_CHAR szMaskPaddingChars[ MAX_PATH ]; 
   L_INT nCounterStep; 
   L_INT nCounterInitialValue; 
   L_BOOL bUpperCase; 
   L_INT nCounterAlphaStart; 
   L_INT nCounterAlphaEnd; 
} EPNALPHATAGDATA, L_FAR * pEPNALPHATAGDATA;

The EPNALPHATAGDATA structure provides options for the alphabetical sequence to be used in renaming or naming the files when they are saved.

Member

Description

uStructSize

Size of this structure in bytes, for versioning. Use the sizeof() macro to calculate this value.

bUseMask

Flag that indicates whether to use the nCharactersCount and szMaskPaddingChars members. Possible values are:

 

Value

Meaning

 

TRUE

Use the nCharactersCount and szMaskPaddingChars members.

 

FALSE

Do not use the nCharactersCount and szMaskPaddingChars members.

nCharactersCount

Value that represents the number of padding characters to be used.

szMaskPaddingChars

Character string that contains which characters should be used to fill the mask. The characters available are limited to the value of nCharactersCount member.

nCounterStep

Value that represents the jump in the counter value between one target file name and the next, where the step identifies the next digit in the numerical sequence to be used.

nCounterInitialValue

Value that represents the initial value for the counter.

bUpperCase

Flag that indicates whether to use upper case characters. Possible values are:

 

Value

Meaning

 

TRUE

Use upper case characters.

 

FALSE

Use lower case characters.

nCounterAlphaStart

Value that represents the ASCII code of the Start character to be used in the counter.

nCounterAlphaEnd

Value that represents the ASCII code of the End character to be used in the counter.

Comments

Notice that reversing the character order (nCounterAlphaStart and nCounterAlphaEnd) members where the End character is prior to the Start character has no effect on the result.

This structure is used with the EPNNAMINGOPTIONS and EPNRENAMINGOPTIONS structures.