PRB: IMAPIProp::GetProps May Return Truncated Data for PR_BODY

• Extended Messaging Application Programming Interface (MAPI), version 1.0
• Exchange Development Kit (EDK), versions 4.0, 5.0, 5.5

SYMPTOMS

The IMAPIProp::GetProps method may return truncated data when used to retrieve the PR_BODY property of a message.

CAUSE

The returned maximum data size is determined by the Message Store provider, not the client application.

RESOLUTION

IMAPIProp::OpenProperty should be used instead to retrieve the data and avoid truncation.

MORE INFORMATION

The issue with the IMAPIProp interface is that Service providers that implement this interface usually limit the amount of data they return (typically between 4 KB and 16 KB) in a property during a call to GetProps. When a property contains data that is larger than the threshold of the provider, the E_OUTOFMEMORY error code should be returned in the property value list for that particular property to inform the client application that the information has been truncated. This is a signal to the client that it should attempt an alternate method to retrieve the information.

REFERENCES

"Inside Mapi," by Irving De la Cruz and Les Thaler, page 54, Microsoft Press ISBN 1-57231-312-9

Additional query words:

Keywords : kbAPI kbEDK kbMsg kbMAPI100
Version : WINDOWS:1.0,4.0,5.0,5.5
Platform : WINDOWS
Issue type : kbprb