IMAPIFormMgr::SelectMultipleForms
Hace referencia a: Outlook 2013 | Outlook 2016
Presenta un cuadro de diálogo que permite al usuario seleccionar varios formularios y devuelve una matriz de objetos de información de formulario que describen esos formularios.
HRESULT SelectMultipleForms(
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPCSTR pszTitle,
LPMAPIFOLDER pfld,
LPMAPIFORMINFOARRAY pfrminfoarray,
LPMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
Parameters
ulUIParam
[in] Identificador de la ventana primaria del cuadro de diálogo mostrado.
ulFlags
[in] Máscara de bits de marcas que controla el tipo de las cadenas pasadas. Se puede establecer la marca siguiente:
MAPI_UNICODE
Las cadenas pasadas están en formato Unicode. Si no se establece la marca de MAPI_UNICODE, las cadenas están en formato ANSI.
pszTitle
[in] Puntero a una cadena que contiene el subtítulo del cuadro de diálogo. Si el parámetro pszTitle es NULL, el proveedor de biblioteca de formularios que proporciona los formularios proporciona un subtítulo predeterminado.
pfld
[in] Puntero a la carpeta desde la que se van a seleccionar los formularios. Si el parámetro pfld es NULL, los formularios se seleccionan en el contenedor de formularios local, personal u organización.
pfrminfoarray
[in] Puntero a una matriz de objetos de información de formulario que están preseleccionados para el usuario.
ppfrminfoarray
[out] Puntero a un puntero a la matriz devuelta de objetos de información de formulario.
Valor devuelto
S_OK
La llamada se realizó correctamente y devolvió el valor o los valores esperados.
MAPI_E_BAD_CHARWIDTH
Se estableció la marca de MAPI_UNICODE y la implementación no admite Unicode, o MAPI_UNICODE no se estableció y la implementación solo admite Unicode.
MAPI_E_USER_CANCEL
El usuario canceló la operación, normalmente haciendo clic en el botón Cancelar del cuadro de diálogo.
Comentarios
Los visores de formularios llaman al método IMAPIFormMgr::SelectMultipleForms para presentar primero un cuadro de diálogo que permite al usuario seleccionar varios formularios y, a continuación, recuperar una matriz de objetos de información de formulario que describen los formularios seleccionados. El cuadro de diálogo SelectMultipleForms muestra todos los formularios, independientemente de si están ocultos (es decir, si sus propiedades ocultas están o no desactivadas).
Notas a los implementadores
Si un visor de formularios pasa la marca de MAPI_UNICODE en el parámetro ulFlags , todas las cadenas son Unicode. Los proveedores de bibliotecas de formularios que no admiten cadenas Unicode deben devolver MAPI_E_BAD_CHARWIDTH si se pasa MAPI_UNICODE.