PidTagAttachFilename Canonical Property
Collapse the table of content
Expand the table of content
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. ArchiveDisclaimer

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.

Associated properties:




Data type:



Message attachment

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.

Protocol Specifications


Handles message and attachment objects.


Converts from Internet standard e-mail conventions to message objects.


Specifies the properties of rights-managed encoded messages.


Specifies S/MIME signed and encrypted message properties.


Encodes and decodes message and attachment objects to an efficient stream representation.

Header Files


Provides data type definitions.


Contains definitions of properties listed as alternate names.

© 2016 Microsoft