IMAPIFormMgr::SelectForm
Gilt für: Outlook 2013 | Outlook 2016
Zeigt ein Dialogfeld an, in dem der Benutzer ein Formular auswählen kann, und gibt ein Formularinformationsobjekt zurück, das dieses Formular beschreibt.
HRESULT SelectForm(
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPCSTR pszTitle,
LPMAPIFOLDER pfld,
LPMAPIFORMINFO FAR * ppfrminfoReturned
);
Parameter
ulUIParam
[in] Ein Handle für das übergeordnete Fenster des angezeigten Dialogfelds.
ulFlags
[in] Eine Bitmaske von Flags, die den Typ der übergebenen Zeichenfolgen steuert. Das folgende Flag kann festgelegt werden:
MAPI_UNICODE
Die übergebenen Zeichenfolgen liegen im Unicode-Format vor. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, liegen die Zeichenfolgen im ANSI-Format vor.
pszTitle
[in] Ein Zeiger auf eine Zeichenfolge, die die Untertitel des Dialogfelds enthält. Wenn der pszTitle-Parameter NULL ist, stellt der Formularbibliotheksanbieter eine Standard-Untertitel bereit.
pfld
[in] Ein Zeiger auf den Ordner, aus dem das Formular ausgewählt werden soll. Wenn der pfld-Parameter NULL ist, kann das Formular aus dem lokalen, persönlichen oder organization Formularcontainer ausgewählt werden.
ppfrminfoReturned
[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_BAD_CHARWIDTH
Entweder wurde das flag MAPI_UNICODE festgelegt, und die Implementierung unterstützt Unicode nicht, oder MAPI_UNICODE wurde nicht festgelegt und die Implementierung unterstützt nur Unicode.
MAPI_E_USER_CANCEL
Der Benutzer hat den Vorgang abgebrochen, in der Regel durch Klicken auf die Schaltfläche Abbrechen im Dialogfeld.
Hinweise
Formular-Viewer rufen die IMAPIFormMgr::SelectForm-Methode auf, um zuerst ein Dialogfeld anzuzeigen, in dem der Benutzer ein Formular auswählen und dann ein Formularinformationsobjekt abrufen kann, das das ausgewählte Formular beschreibt. Das Dialogfeld schränkt den Benutzer ein, ein einzelnes Formular auszuwählen.
Hinweise für Aufrufer
Im Dialogfeld SelectForm werden nur Formulare angezeigt, die nicht ausgeblendet sind (d. a. Formulare, deren ausgeblendete Eigenschaften klar sind). Wenn ein Formular-Viewer das MAPI_UNICODE-Flag im ulFlags-Parameter übergibt, sind alle Zeichenfolgen Unicode. Formularbibliotheksanbieter, die unicode-Zeichenfolgen nicht unterstützen, sollten MAPI_E_BAD_CHARWIDTH zurückgeben, wenn MAPI_UNICODE übergeben wird.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| FolderDlg.cpp |
CFolderDlg::OnSelectForm |
MFCMAPI verwendet die IMAPIFormMgr::SelectForm-Methode , um ein Formular auszuwählen und Informationen zum Formular an ein oder mehrere Protokolle zu senden. |