typedef struct tag_EPNALPHANUMTAGDATA
{
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;
L_INT nCounterNumStart;
L_INT nCounterNumEnd;
} EPNALPHANUMTAGDATA, L_FAR * pEPNALPHANUMTAGDATA;
The EPNALPHANUMTAGDATA structure provides options for the alphanumerical sequence to be used in renaming or naming 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 the 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 character in the ALPHABIT 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. |
|
|
nCounterNumStart |
Value that represents the start numerical digit to be used in the counter. |
|
|
nCounterNumEnd |
Value that represents 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.
Notice that reversing the digits order (nCounterNumStart and nCounterNumEnd) members where the end digit is prior to the start digit has no effect on the result.
This structure is used with the EPNNAMINGOPTIONS and EPNRENAMINGOPTIONS structures.