Freigeben über


IMAPIFormContainer::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 szMessageClass,
  ULONG ulFlags,
  LPMAPIFORMINFO FAR * ppforminfo
);

Parameter

szMessageClass

[in] Eine Zeichenfolge, die die aufgelöste Nachrichtenklasse benennt. Nachrichtenklassennamen sind immer ANSI-Zeichenfolgen, nie Unicode.

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.

ppforminfo

[out] Ein Zeiger auf einen Zeiger auf das zurückgegebene 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 szMessageClass-Parameter übergebene Nachrichtenklasse stimmt nicht mit der Nachrichtenklasse für ein Formular im Formularcontainer überein.

Hinweise

Clientanwendungen rufen die IMAPIFormContainer::ResolveMessageClass-Methode auf, um eine Nachrichtenklasse in ein Formular in einem Formularcontainer aufzulösen. Das im ppforminfo-Parameter zurückgegebene Formularinformationsobjekt bietet weiteren Zugriff auf die Eigenschaften des Formulars mit der angegebenen Nachrichtenklasse.

Hinweise für Aufrufer

Um eine Nachrichtenklasse in ein Formular aufzulösen, übergeben Sie den Namen der aufzulösden Nachrichtenklasse (z. B IPM.HelpDesk.Software. ). Um zu erzwingen, dass die Auflösung exakt ist (d. h. um die Auflösung in eine Basisklasse der Nachrichtenklasse zu verhindern), kann das MAPIFORM_EXACTMATCH-Flag im ulFlags-Parameter übergeben werden.

Der Klassenbezeichner für die aufgelöste Nachrichtenklasse wird als Teil des Formularinformationsobjekts zurückgegeben. Gehen Sie erst nach dem Aufruf der IMAPIFormMgr::P repareForm - oder der IMAPIFormMgr::CreateForm-Methode davon aus, dass der Klassenbezeichner in der OLE-Bibliothek vorhanden ist.

MFCMAPI-Referenz

Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.

Datei Funktion Kommentar
FormContainerDlg.cpp
CFormContainerDlg::OnResolveMessageClass
MFCMAPI verwendet die IMAPIFormContainer::ResolveMessageClass-Methode , um ein Formular zu suchen, das einer Nachrichtenklasse zugeordnet ist.

Siehe auch

IMAPIFormInfo : IMAPIProp

IMAPIFormMgr::CreateForm

IMAPIFormMgr::PrepareForm

IMAPIFormContainer : IUnknown