Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: Outlook 2013 | Outlook 2016
Löst eine Nachrichtenklasse in ihr Formular innerhalb eines Formularcontainers 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 aufzulösende Nachrichtenklasse benennt.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie die Nachrichtenklasse aufgelöst wird. Die folgende Kennzeichnung kann festgelegt werden:
MAPIFORM_EXACTMATCH
Nur Nachrichtenklassenzeichenfolgen, die eine genaue Übereinstimmung aufweisen, sollten aufgelöst werden.
pFolderFocus
[in] Ein Zeiger auf den Ordner, der die aufzulösende Nachricht enthält. Der Parameter pFolderFocus 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 übergebene Nachrichtenklasse stimmt für kein Formular in der Formularbibliothek mit der Nachrichtenklasse überein.
Hinweise
Formularanzeigen rufen die IMAPIFormMgr::ResolveMessageClass-Methode auf, um eine Nachrichtenklasse in ihr Formular innerhalb eines Formularcontainers aufzulösen. Das Formularinformationsobjekt, das im ppResult--Parameter zurückgegeben wird, 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 Formularanzeiger den Namen der aufzulösenden Nachrichtenklasse, z. B. „IPM.HelpDesk.Software“. Um zu erzwingen, dass die Auflösung genau ist (d. h., um die Auflösung in einer Basisklasse der Nachrichtenklasse zu verhindern, wenn kein exakt übereinstimmender Formularserver verfügbar ist), kann die Kennzeichnung MAPIFORM_EXACTMATCH im ulFlags-Parameter übergeben werden. Wenn der Parameter pFolderFocus NULL ist, durchsucht der Auflösungsprozess der Nachrichtenklasse keinen Ordnercontainer.
Die Reihenfolge der durchsuchten Container hängt von der Implementierung des Anbieters der Formularbibliothek 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 Organisationscontainer.
Nachrichtenklassennamen sind immer ANSI-Zeichenfolgen, niemals Unicode.
Der Klassenbezeichner für die aufgelöste Nachrichtenklasse wird als Teil des Formularinformationsobjekts zurückgegeben. Ein Formular-Viewer sollte erst unter der Annahme funktionieren, dass der Klassenbezeichner in der OLE-Bibliothek vorhanden ist, nachdem der Formular-Viewer entweder die IMAPIFormMgr::P repareForm-Methode oder die IMAPIFormMgr::CreateForm-Methode aufgerufen hat.