| Platform SDK: MAPI |
The PR_ATTACH_FILENAME property contains an attachment's base filename and extension, excluding path.
| Header file: | MAPITAGS.H |
| May be exposed by: | Attachment subobjects |
| Identifier: | 0x3704 |
| Property type: | PT_TSTRING |
| Property tag: | 0x3704001E (0x3704001F for Unicode) |
| Corresponding X.400 attribute: | IM_EXTERNAL_PARAMETERS |
It is recommended that messaging user objects expose the PR_ATTACH_FILENAME property. PR_ATTACH_FILENAME 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. PR_ATTACH_FILENAME is required when any of these values is used.
PR_ATTACH_FILENAME can be used as a suggested filename for saving the attachment and to supply the filename extension if the PR_ATTACH_EXTENSION property is not provided.
The filename is restricted to eight characters plus a three-character extension. For a platform that supports long filenames, set both this property and the PR_ATTACH_LONG_FILENAME property.
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.