IMAPIFormMgr::SelectMultipleForms
Gilt für: Outlook 2013 | Outlook 2016
Stellt ein Dialogfeld dar, in dem der Benutzer mehrere Formulare auswählen kann, und gibt ein Array von Formularinformationsobjekten zurück, die diese Formulare beschreiben.
HRESULT SelectMultipleForms(
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPCSTR pszTitle,
LPMAPIFOLDER pfld,
LPMAPIFORMINFOARRAY pfrminfoarray,
LPMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
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, der die Formulare bereitstellt, eine Standard-Untertitel bereit.
pfld
[in] Ein Zeiger auf den Ordner, aus dem die Formulare ausgewählt werden sollen. Wenn der pfld-Parameter NULL ist, werden die Formulare aus dem lokalen, persönlichen oder organization Formularcontainer ausgewählt.
pfrminfoarray
[in] Ein Zeiger auf ein Array von Formularinformationsobjekten, die für den Benutzer vorab ausgewählt sind.
ppfrminfoarray
[out] Ein Zeiger auf einen Zeiger auf das zurückgegebene Array von Formularinformationsobjekten.
Rückgabewert
S_OK
Der Aufruf war erfolgreich und hat den erwarteten Wert oder die erwarteten Werte zurückgegeben.
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::SelectMultipleForms-Methode auf, um zuerst ein Dialogfeld anzuzeigen, in dem der Benutzer mehrere Formulare auswählen und dann ein Array von Formularinformationsobjekten abrufen kann, die die ausgewählten Formulare beschreiben. Im Dialogfeld SelectMultipleForms (SelectMultipleForms ) werden alle Formulare angezeigt, unabhängig davon, ob sie ausgeblendet sind (d. a. ob ihre ausgeblendeten Eigenschaften eindeutig sind oder nicht).
Hinweise für Implementierer
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.