Microsoft KB Archive/184269

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

Article ID: 184269

Article Last Modified on 8/18/2005

-

APPLIES TO


 * Microsoft Messaging Application Programming Interface
 * Microsoft Exchange Development Kit 5.5
 * Microsoft Exchange Development Kit 5.5
 * Microsoft Exchange Server 2003 Software Development Kit

-



This article was previously published under Q184269



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.

