IMAPIFormMgr::ResolveMessageClass
Gilt für: Outlook 2013 | Outlook 2016
Löst eine Nachrichtenklasse in ihr Formular in einem Formularcontainer auf und gibt ein Formularinformationsobjekt für dieses Formular zurück.
HRESULT ResolveMessageClass(
LPCSTR szMsgClass,
ULONG ulFlags,
LPMAPIFOLDER pFolderFocus,
LPMAPIFORMINFO FAR * ppResult
);
Parameter
szMsgClass
[in] Eine Zeichenfolge, die die aufgelöste Nachrichtenklasse benennt.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie die Nachrichtenklasse aufgelöst wird. Das folgende Flag kann festgelegt werden:
MAPIFORM_EXACTMATCH
Nur Nachrichtenklassenzeichenfolgen, die eine genaue Übereinstimmung sind, sollten aufgelöst werden.
pFolderFocus
[in] Ein Zeiger auf den Ordner, der die aufgelöste Nachricht enthält. Der pFolderFocus-Parameter kann NULL sein.
ppResult
[out] Ein Zeiger auf einen Zeiger auf ein zurückgegebenes Formularinformationsobjekt.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgef�hrt und der erwartete Wert oder Werte zur�ckgegeben hat.
MAPI_E_NOT_FOUND
Die im szMsgClass-Parameter übergebene Nachrichtenklasse stimmt nicht mit der Nachrichtenklasse für ein Formular in der Formularbibliothek überein.
Hinweise
Formularanzeiger rufen die IMAPIFormMgr::ResolveMessageClass-Methode auf, um eine Nachrichtenklasse in ihr Formular in einem Formularcontainer aufzulösen. Das im ppResult-Parameter zurückgegebene Formularinformationsobjekt bietet weiteren Zugriff auf die Eigenschaften des Formulars, das über die angegebene Nachrichtenklasse verfügt.
Hinweise für Aufrufer
Um eine Nachrichtenklasse in ein Formular aufzulösen, übergibt ein Formular-Viewer den Namen der aufzulösden Nachrichtenklasse, z. B. " IPM.HelpDesk.Software". 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. Wenn der pFolderFocus-Parameter NULL ist, durchsucht der Nachrichtenklassenauflösungsprozess keinen Ordnercontainer.
Die Reihenfolge der durchsuchten Container hängt von der Implementierung des Formularbibliotheksanbieters ab. Der Standardanbieter der Formularbibliothek durchsucht zuerst den lokalen Container, dann den Ordnercontainer für den übergebenen Ordner, den Persönlichen Formularcontainer und schließlich den organization Container.
Nachrichtenklassennamen sind immer ANSI-Zeichenfolgen, nie Unicode.
Der Klassenbezeichner für die aufgelöste Nachrichtenklasse wird als Teil des Formularinformationsobjekts zurückgegeben. Ein Formular-Viewer sollte nicht unter der Annahme funktionieren, dass der Klassenbezeichner in der OLE-Bibliothek vorhanden ist, bis der Formular-Viewer entweder die IMAPIFormMgr::P repareForm-Methode oder die IMAPIFormMgr::CreateForm-Methode aufgerufen hat.