|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here.|
PidTagAttachFilename Canonical Property
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Contains an attachment's base file name and extension, excluding path.
PR_ATTACH_FILENAME, PR_ATTACH_FILENAME_A, PR_ATTACH_FILENAME_W
It is recommended that attachment objects expose these properties which pertain to the ATTACH_BY_VALUE, ATTACH_BY_REFERENCE, ATTACH_BY_REF_RESOLVE, and ATTACH_BY_REF_ONLY values of the PR_ATTACH_METHOD (PidTagAttachMethod) property. PR_ATTACH_FILENAME and associated properties are required when any of these values is used.
These properties can be used as a suggested file name for saving the attachment and to supply the file name extension if the PR_ATTACH_EXTENSION (PidTagAttachExtension) property is not provided.
The file name is restricted to eight characters plus a three-character extension. For a platform that supports long file names, set both this property and the PR_ATTACH_LONG_FILENAME (PidTagAttachLongFilename) property.
MAPI works only with file names, and other strings passed to it, in the American National Standards Institute (ANSI) character set. Client applications that use file names in an original equipment manufacturer (OEM) character set must convert them to ANSI before calling MAPI.