PidTagAttachLongFilename Canonical Property

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Contains an attachment's long filename and extension, excluding path.

Associated properties:

PR_ATTACH_LONG_FILENAME, PR_ATTACH_LONG_FILENAME_A, PR_ATTACH_LONG_FILENAME_W

Identifier:

0x3707

Data type:

PT_STRING8, PT_UNICODE

Area:

Message attachment

Remarks

These properties 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. Platforms that support long filenames should set both the PR_ATTACH_LONG_FILENAME and PR_ATTACH_FILENAME (PidTagAttachFilename) 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 (PidTagAttachExtension) 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 in the ANSI character set. Client applications that use filenames in an OEM character set must convert them to ANSI before calling MAPI.

Protocol Specifications

  • [MS-OXCMSG]
    Handles message and attachment objects.

  • [MS-OXCMAIL]
    Converts from Internet standard e-mail conventions to message objects.

  • [MS-OXORMMS]
    Specifies the properties of rights-managed encoded messages.

  • [MS-OXOUM]
    Specifies the properties and operations that are permissible for representing voice mail and fax messages.

Header Files

  • Mapidefs.h
    Provides data type definitions.

  • Mmapitags.h
    Contains definitions of properties listed as alternate names.

See Also

Concepts

MAPI Properties

MAPI Canonical Properties

Mapping Canonical Property Names to MAPI Names

Mapping MAPI Names to Canonical Property Names