PRB: IMAPIProp::GetProps May Return Truncated Data for PR_BODY (184269)
The information in this article applies to:
- Microsoft Extended Messaging Application Programming Interface (MAPI)
- Microsoft Exchange Development Kit (EDK) 4.0
- Microsoft Exchange Development Kit (EDK) 5.0
- Microsoft Exchange Development Kit (EDK) 5.5
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.
REFERENCES
"Inside Mapi," by Irving De la Cruz and Les Thaler, page 54, Microsoft
Press ISBN 1-57231-312-9
Modification Type: | Minor | Last Reviewed: | 8/18/2005 |
---|
Keywords: | kbAPI kbMsg kbprb KB184269 |
---|
|