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 aufzulösende Nachrichtenklasse benennt. Nachrichtenklassennamen sind immer ANSI-Zeichenfolgen, niemals Unicode.

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.

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 beliebiger Form im Formularcontainer überein.

Hinweise

Clientanwendungen rufen die IMAPIFormContainer::ResolveMessageClass-Methode auf, um eine Nachrichtenklasse in ein Formular innerhalb eines Formularcontainers aufzulösen. Das Formularinformationsobjekt, das im ppforminfo-Parameter zurückgegeben wird, 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ösenden 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 dann davon aus, dass der Klassenbezeichner in der OLE-Bibliothek vorhanden ist, nachdem Sie entweder die IMAPIFormMgr::PrepareForm oder IMAPIFormMgr::CreateForm-Methode aufgerufen haben.

MFCMAPI-Referenz

Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.

Siehe auch

IMAPIFormInfo : IMAPIProp

IMAPIFormMgr::CreateForm

IMAPIFormMgr::PrepareForm

IMAPIFormContainer : IUnknown