Handling Named Property Errors
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. ArchiveDisclaimer

Handling Named Property Errors

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.

When a request is made to IMAPIProp::GetIDsFromNames or IMAPIProp::GetNamesFromIDs that is too large for the implementer to handle, the error value MAPI_E_TOO_BIG is returned. Callers must divide their request into several requests, calling the appropriate method in a loop.

When a call results in partial success, such as when the request is for names that map to specific identifiers and one or more names cannot be found, GetNamesFromIDs returns MAPI_W_ERRORS_RETURNED and places PT_ERROR in the property type for the missing property in the property tag array.

Sometimes a client makes a call to GetNamesFromIDs that results in no properties being returned, such as when there are no properties in a specified property set, or when all named properties are of a type excluded by the flags. Clients can expect service providers to:

  • Return S_OK.

  • Set the contents of the property tag array pointer to a newly allocated property tag array with its cValues member set to zero.

  • Set the contents of the MAPINAMEID structure array to NULL.

  • Set the contents of the count of MAPINAMEID structures to zero.

© 2016 Microsoft