IMAPIFormContainer::ResolveMultipleMessageClasses

The IMAPIFormContainer::ResolveMultipleMessageClasses method resolves a group of message classes to their forms within a form container and returns an array of form information objects for those forms.

Quick Info

See IMAPIFormContainer : IUnknown.

HRESULT ResolveMultipleMessageClasses (
  LPSMESSAGECLASSARRAY pMsgClassArray,   
  ULONG ulFlags,                         
  LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray  
);
 

Parameters

pMsgClassArray

[in] Pointer to an array containing the names of the message classes to resolve. Message class names are always ANSI strings, never Unicode.

ulFlags

[in] Bitmask of flags that controls how the message classes are resolved. The following flag can be set:

MAPIFORM_EXACTMATCH

Only message class strings that are an exact match should be resolved.

ppfrminfoarray

[out] Pointer to a pointer to an array of form information objects. If a client application passes NULL in the pMsgClassArray parameter, the ppfrminfoarray parameter contains form information objects for all forms in the container.

Return Values

S_OK

The call succeeded and has returned the expected value or values.

Remarks

Client applications call the IMAPIFormContainer::ResolveMultipleMessageClasses method to resolve a group of message classes to forms within a form container. The array of form information objects returned in the ppfrminfoarray parameter provides further access to each of the forms' properties.

Notes to Callers

To resolve a group of message classes to forms, pass in an array of message class names to be resolved. To force the resolution to be exact — that is, to prevent resolution to a superclass of the message class — the MAPIFORM_EXACTMATCH flag can be passed in the ulFlags parameter.

If a message class cannot be resolved to a form, NULL is returned for that message class in the form information array. Therefore, even if the method returns S_OK, do not assume that all message classes have been successfully resolved. Instead, check the values in the returned array.

See Also

IMAPIFormContainer::ResolveMessageClass