IMAPISession::ShowForm
Hace referencia a: Outlook 2013 | Outlook 2016
Muestra un formulario.
HRESULT ShowForm(
ULONG_PTR ulUIParam,
LPMDB lpMsgStore,
LPMAPIFOLDER lpParentFolder,
LPCIID lpInterface,
ULONG ulMessageToken,
LPMESSAGE lpMessageSent,
ULONG ulFlags,
ULONG ulMessageStatus,
ULONG ulMessageFlags,
ULONG ulAccess,
LPSTR lpszMessageClass
);
Parameters
ulUIParam
[in] Identificador de la ventana primaria del formulario.
lpMsgStore
[in] Puntero al almacén de mensajes que contiene la carpeta a la que apunta el parámetro lpParentFolder .
lpParentFolder
[in] Puntero a la carpeta en la que se creó el mensaje asociado al parámetro ulMessageToken .
lpInterface
[in] Puntero al identificador de interfaz (IID) que representa la interfaz que se va a usar para acceder al mensaje que se muestra en el formulario. El parámetro lpInterface debe ser NULL o IID_IMessage. Si se pasa NULL, se usa la interfaz estándar , IMessage.
ulMessageToken
[in] Token asociado al mensaje que se va a mostrar en el formulario. El parámetro ulMessageToken debe establecerse en el contenido del parámetro lpulMessageToken de la llamada anterior a IMAPISession::P repareForm.
lpMessageSent
[in] Reservados; debe ser NULL.
ulFlags
[in] Máscara de bits de marcas que controla cómo y si se guarda el mensaje. Se pueden establecer las siguientes marcas:
MAPI_NEW_MESSAGE
El mensaje nunca se ha guardado (es decir, nunca se ha llamado a su método IMAPIProp::SaveChanges ).
MAPI_POST_MESSAGE
El mensaje debe guardarse en su carpeta primaria. El mensaje no se procesa para el envío, sino que se publica en la carpeta. Si no se establece esta marca, el mensaje se copia en la Bandeja de salida y se procesa para su envío.
ulMessageStatus
[in] Máscara de bits de marcas copiadas de la propiedad PR_MSG_STATUS (PidTagMessageStatus) del mensaje asociado al token en el parámetro ulMessageToken . Las marcas proporcionan información sobre el estado del mensaje.
ulMessageFlags
[in] Máscara de bits de marcas copiadas de la propiedad PR_MESSAGE_FLAGS (PidTagMessageFlags) del mensaje asociado al token en el parámetro ulMessageToken . Estas marcas proporcionan más información sobre el estado del mensaje.
ulAccess
[in] Marca que indica el nivel de permiso del mensaje que se muestra en el formulario. Esta información se copia de la propiedad PR_ACCESS (PidTagAccess) del mensaje asociado al token en el parámetro ulMessageToken .
lpszMessageClass
[in] Puntero a la clase de mensaje del mensaje que se muestra en el formulario, copiado de la propiedad PR_MESSAGE_CLASS (PidTagMessageClass) del mensaje asociado al token en el parámetro ulMessageToken .
Valor devuelto
S_OK
El formulario se mostró correctamente.
MAPI_E_USER_CANCEL
El usuario canceló la operación, normalmente haciendo clic en el botón Cancelar de un cuadro de diálogo.
Comentarios
El método IMAPISession::ShowForm muestra un formulario de mensaje preparado por el método IMAPISession::P repareForm .
Notas para los llamadores
Solo debe tener una sola referencia al mensaje pasado en el parámetro lpMessage del método PrepareForm.
Tenga en cuenta que las implementaciones de formulario pueden devolver valores de error distintos de los documentados por MAPI. Si puede usar estos valores de error para realizar una determinación más precisa de la condición de error, hágalo. De lo contrario, controle estos errores como controlaría MAPI_E_CALL_FAILED.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MAPIFormFunctions.cpp |
OpenMessageModal |
MFCMAPI usa el método IMAPISession::ShowForm , junto con el método PrepareForm , para mostrar un mensaje en un formulario modal. |