IMAPIFormMgr::SelectForm

Gilt für: Outlook 2013 | Outlook 2016

Zeigt ein Dialogfeld an, in dem Benutzende ein Formular auswählen können, 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 Kennzeichnungen, die den Typ der übergebenen Zeichenfolgen steuert. Die folgende Kennzeichnung kann festgelegt werden:

MAPI_UNICODE

Die übergebenen Zeichenfolgen entsprechen dem Unicode-Format. Wenn die MAPI_UNICODE-Kennzeichnung nicht festgelegt ist, liegen die Zeichenfolgen im ANSI-Format vor.

pszTitle

[in] Ein Zeiger auf eine Zeichenfolge, die die Überschrift des Dialogfelds enthält. Wenn der Parameter pszTitle NULL ist, stellt der Formularbibliotheksanbieter eine Standardbeschriftung 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 Organisationsformularcontainer 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 MAPI_UNICODE-Kennzeichnung festgelegt und die Implementierung unterstützt kein Unicode, 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

Formularanzeigen 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. h. Formulare, deren ausgeblendete Eigenschaften deaktiviert sind). Wenn ein Formular-Viewer die Kennzeichnung MAPI_UNICODE 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.

Siehe auch

IMAPIFormMgr : IUnknown

MFCMAPI (engl.) als ein Codebeispiel