IMAPIFormMgr::ResolveMultipleMessageClasses
Gilt für: Outlook 2013 | Outlook 2016
Löst eine Gruppe von Nachrichtenklassen in ihre Formulare innerhalb eines Formularcontainers auf und gibt ein Array von Formularinformationsobjekten für diese Formulare zurück.
HRESULT ResolveMultipleMessageClasses(
LPSMESSAGECLASSARRAY pMsgClasses,
ULONG ulFlags,
LPMAPIFOLDER pFolderFocus,
LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
Parameter
pMsgClasses
[in] Ein Zeiger auf ein Array, das die Namen der aufzulösden Nachrichtenklassen enthält.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie die Nachrichtenklassen aufgelöst werden. Das folgende Flag kann festgelegt werden:
MAPIFORM_EXACTMATCH
Nur Nachrichtenklassenzeichenfolgen, die eine genaue Übereinstimmung sind, sollten aufgelöst werden.
MAPIFORM_LOCALONLY
Schließen Sie keine zwischengespeicherten Formulare ein.
pFolderFocus
[in] Ein Zeiger auf den Ordner, der das Formular enthält, dessen Nachrichtenklasse aufgelöst wird. Der pFolderFocus-Parameter kann NULL sein.
ppfrminfoarray
[out] Ein Zeiger auf einen Zeiger auf ein Array von Formularinformationsobjekten. Wenn ein Formular-Viewer NULL im pMsgClasses-Parameter übergibt, enthält der ppfrminfoarray-Parameter Formularinformationsobjekte für alle Formulare im Container.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgef�hrt und der erwartete Wert oder Werte zur�ckgegeben hat.
Hinweise
Formularanzeiger rufen die IMAPIFormMgr::ResolveMultipleMessageClasses-Methode auf, um eine Gruppe von Nachrichtenklassen in Formularen in einem Formularcontainer aufzulösen. Das Array von Formularinformationsobjekten, das in ppfrminfoarray zurückgegeben wird, bietet weiteren Zugriff auf die eigenschaften der Formulare.
Hinweise für Aufrufer
Um eine Gruppe von Nachrichtenklassen in Formulare aufzulösen, übergibt ein Formular-Viewer ein Array von Nachrichtenklassennamen, die aufgelöst werden sollen. Um zu erzwingen, dass die Auflösung genau ist (d. h. um die Auflösung in eine Basisklasse der Nachrichtenklasse zu verhindern, wenn ein genau übereinstimmenden Formularserver nicht verfügbar ist), kann das MAPIFORM_EXACTMATCH-Flag im ulFlags-Parameter übergeben werden.
Nachrichtenklassennamen sind immer ANSI-Zeichenfolgen, nie Unicode.
Wenn eine Nachrichtenklasse nicht in ein Formular aufgelöst werden kann, wird NULL für diese Nachrichtenklasse im Formularinformationsarray zurückgegeben. Selbst wenn die Methode S_OK zurückgibt, sollten Formular-Viewer daher nicht davon ausgehen, dass alle Nachrichtenklassen erfolgreich aufgelöst wurden. Stattdessen sollten Formular-Viewer die Werte im zurückgegebenen Array überprüfen.