| Platform SDK: MAPI |
The PR_ATTACH_LONG_FILENAME property contains an attachment's long filename and extension, excluding path.
| Header file: | MAPITAGS.H |
| May be exposed by: | Attachment subobjects |
| Identifier: | 0x3707 |
| Property type: | PT_TSTRING |
| Property tag: | 0x3707001E (0x3707001F for Unicode) |
The PR_ATTACH_LONG_FILENAME property pertains to the ATTACH_BY_VALUE, ATTACH_BY_REFERENCE, ATTACH_BY_REF_RESOLVE, and ATTACH_BY_REF_ONLY values of the PR_ATTACH_METHOD property. Platforms that support long filenames should set both the PR_ATTACH_LONG_FILENAME and PR_ATTACH_FILENAME properties when sending, and should check PR_ATTACH_LONG_FILENAME first when receiving.
The client application should set this property to a suggested long filename to be used if the host computer receiving a message supports long filenames. PR_ATTACH_LONG_FILENAME can be used as a filename for saving the attachment, and to supply the filename extension if the PR_ATTACH_EXTENSION property is not provided.
Unlike the filename provided by PR_ATTACH_FILENAME, this name is not restricted to an eight-character filename plus a three-character extension. Instead, it can be up to 256 characters long, including the filename, extension, and separator period.
MAPI works only with filenames, and other strings passed to it, in the ANSI character set. Client applications that use filenames in an OEM character set must convert them to ANSI before calling MAPI.