IMAPIFormMgr::OpenFormContainer
Gilt für: Outlook 2013 | Outlook 2016
Öffnet eine IMAPIFormContainer-Schnittstelle für einen bestimmten Formularcontainer.
HRESULT OpenFormContainer(
HFRMREG hfrmreg,
LPUNKNOWN lpunk,
LPMAPIFORMCONTAINER FAR * lppfcnt
);
Parameter
hfrmreg
[in] Eine HFRMREG-Enumeration, die die zu öffnende Formularbibliothek angibt (d. h. den zu öffnenden Formularcontainer). Eine HFRMREG-Enumeration ist eine Enumeration, die für einen Formularbibliotheksanbieter spezifisch ist. Mögliche HFRMREG-Werte sind:
HFRMREG_DEFAULT
Ein praktischer Formularcontainer.
HFRMREG_FOLDER
Ein Ordnercontainer.
HFRMREG_PERSONAL
Der Container für den Standardnachrichtenspeicher.
HFRMREG_LOCAL
Ein lokaler Formularcontainer.
lpunk
[in] Ein Zeiger auf das Objekt, für das die Schnittstelle geöffnet wird. Der lpunk-Parameter muss NULL sein, es sei denn, der Wert für den hfrmreg-Parameter erfordert einen Objektzeiger.
lppfcnt
[out] Ein Zeiger auf einen Zeiger auf das zurückgegebene Formularcontainerobjekt.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgef�hrt und der erwartete Wert oder Werte zur�ckgegeben hat.
MAPI_E_NO_INTERFACE
Das Objekt, auf das von lpunk verwiesen wird, unterstützt die erforderliche Schnittstelle nicht.
Hinweise
Formular-Viewer rufen die IMAPIFormMgr::OpenFormContainer-Methode auf, um eine IMAPIFormContainer-Schnittstelle für einen bestimmten Formularcontainer zu öffnen. Diese Schnittstelle kann dann zum Installieren und Entfernen von Formularen in einem Formularcontainer verwendet werden.
Hinweise für Aufrufer
Wenn der Wert in hfrmreg HFRMREG_FOLDER ist, muss der in lpunk verwendete Schnittstellenbezeichner ungleich NULL sein und muss IUnknown::QueryInterface-Methodenaufrufe an eine IMAPIFolder-Schnittstelle zulassen.
Um den lokalen Formularcontainer zu öffnen, müssen Sie einen Aufruf der OpenFormContainer-Methode oder der MAPIOpenLocalFormContainer-Funktion verwenden. Sie können die IMAPIFormMgr::SelectFormContainer-Methode nicht verwenden, um dem Benutzer die Auswahl des lokalen Formularcontainers zu ermöglichen.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MainDlg.cpp |
CMainDlg::OnOpenFormContainer |
MFCMAPI verwendet die IMAPIFormMgr::OpenFormContainer-Methode , um einen Formularcontainer abzurufen, damit der Inhalt des Containers gerendert werden kann. |
| MsgStoreDlg.cpp |
CMsgStoreDlg::OnOpenFormContainer |
MFCMAPI verwendet die IMAPIFormMgr::OpenFormContainer-Methode , um einen Formularcontainer für einen Ordner abzurufen, damit der Inhalt des Containers gerendert werden kann. |
Siehe auch
IMAPIFormContainer::InstallForm