|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.|
PidTagAttachRendering 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 a Microsoft Windows metafile with rendering information for an attachment.
The purpose of this property is to provide an icon or other pictorial representation that can be displayed within the parent message at the point of attachment. Such representation typically includes the name of the attachment, if any, and the nature of the attachment, such as a Microsoft Office Word document. A client application can use this representation in the display of the message.
For an attached file, this property usually portrays an icon for the file.
For an attached message, this property is typically not set. A client application needing to render an attached message should obtain its PR_MESSAGE_CLASS (PidTagMessageClass) property, call IMAPIFormMgr::ResolveMessageClass for a pointer to the corresponding form information object, open the IMAPIFormInfo interface on that object, and use GetProps to retrieve the PR_ICON (PidTagIcon) or PR_MINI_ICON (PidTagMiniIcon) property.
For an embedded static OLE object, this property contains a Microsoft Windows metafile that can be used to draw the attachment representation in a window.
For an embedded dynamic OLE object, the client should use the OLE data to generate the rendering information.
In all cases, the client application should be aware that this property is usually several hundred bytes in size and is subject to truncation in the attachment table. If a client wishes to render the attachment from this property without opening the attachment itself, it must work within the table truncation rule. For more information, see Working with Large Columns.