Handling Named Property Errors
Collapse the table of content
Expand the table of content
The document is archived and information here might be outdated

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