IMAPIFormMgr::SelectForm
Hace referencia a: Outlook 2013 | Outlook 2016
Presenta un cuadro de diálogo que permite al usuario seleccionar un formulario y devuelve un objeto de información del formulario que describe ese formulario.
HRESULT SelectForm(
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPCSTR pszTitle,
LPMAPIFOLDER pfld,
LPMAPIFORMINFO FAR * ppfrminfoReturned
);
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 proporciona un subtítulo predeterminado.
pfld
[in] Puntero a la carpeta desde la que se va a seleccionar el formulario. Si el parámetro pfld es NULL, el formulario se puede seleccionar en el contenedor de formularios local, personal u organización.
ppfrminfoReturned
[out] Puntero a un puntero al objeto de información de formulario devuelto.
Valor devuelto
S_OK
La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.
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::SelectForm para presentar primero un cuadro de diálogo que permite al usuario seleccionar un formulario y, a continuación, recuperar un objeto de información del formulario que describe el formulario seleccionado. El cuadro de diálogo restringe al usuario a seleccionar un único formulario.
Notas para los llamadores
El cuadro de diálogo SelectForm solo muestra formularios que no están ocultos (es decir, formularios que tienen sus propiedades ocultas desactivadas). 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.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| FolderDlg.cpp |
CFolderDlg::OnSelectForm |
MFCMAPI usa el método IMAPIFormMgr::SelectForm para seleccionar un formulario y enviar información sobre el formulario a uno o varios registros. |