PidTagAttachPathname Canonical Property

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Contains an attachment's fully-qualified path and filename.

Associated properties:

PR_ATTACH_PATHNAME, PR_ATTACH_PATHNAME_A, PR_ATTACH_PATHNAME_W

Identifier:

0x3708

Data type:

PT_STRING8, PT_UNICODE

Area:

Message attachment

Remarks

It is recommended that attachment subobjects expose these properties. Setting them indicates that the attachment data is not included with the message but is available on a common file server. These properties are required in conjunction with any of the PR_ATTACH_METHOD (PidTagAttachMethod) flags that indicate attachment by reference: ATTACH_BY_REFERENCE, ATTACH_BY_REF_RESOLVE, or ATTACH_BY_REF_ONLY.

Each directory or filename is restricted to an eight-character name plus a three-character extension. The overall path is restricted to 256 characters. For a platform that supports long filenames, set both these properties and PR_ATTACH_LONG_PATHNAME (PidTagAttachLongPathname).

Client applications should use a universal naming convention (UNC) in most cases when the file is shared, and should use an absolute path when the file is local.

MAPI works only with paths and filenames in the ANSI character set. Clients that use paths and filenames in an OEM character set must convert them to ANSI before calling MAPI.

Protocol Specifications

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

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

Header Files

  • Mapidefs.h
    Provides data type definitions.

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

See Also

Reference

ScLocalPathFromUNC

ScUNCFromLocalPath

Concepts

MAPI Properties

MAPI Canonical Properties

Mapping Canonical Property Names to MAPI Names

Mapping MAPI Names to Canonical Property Names