IMAPIFormMgr::CreateForm
Hace referencia a: Outlook 2013 | Outlook 2016
Abre un formulario para crear un nuevo mensaje basado en la clase de mensaje del formulario.
HRESULT CreateForm(
ULONG_PTR ulUIParam,
ULONG ulFlags,
IMAPIFormInfo pfrminfoToActivate,
REFIID refiidToAsk,
LPVOID FAR * ppvObj
);
Parameters
ulUIParam
[in] Identificador de la ventana primaria para el indicador de progreso que se muestra mientras se abre el formulario. El parámetro ulUIParam se omite a menos que se establezca la marca de MAPI_DIALOG en el parámetro ulFlags .
ulFlags
[in] Máscara de bits de marcas que controla cómo se abre el formulario. Se puede establecer la marca siguiente:
MAPI_DIALOG
Muestra una interfaz de usuario para proporcionar el estado o pedir al usuario más información. Si no se establece esta marca, no se muestra ninguna interfaz de usuario.
pfrminfoToActivate
[in] Puntero al objeto de información del formulario que se usa para abrir el formulario.
refiidToAsk
[in] Puntero al identificador de interfaz (IID) de la interfaz que se va a devolver para el objeto de formulario que se creó. El parámetro refiidToAsk no debe ser NULL.
ppvObj
[out] Puntero a un puntero a la interfaz devuelta.
Valor devuelto
S_OK
La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.
MAPI_E_NO_INTERFACE
El objeto form no admite la interfaz solicitada.
Comentarios
Los visores de formularios llaman al método IMAPIFormMgr::CreateForm para abrir un formulario para crear un nuevo mensaje basado en la clase de mensaje del formulario. CreateForm abre el formulario mediante la creación de una instancia del servidor de formularios para ese formulario, tal como se describe en el objeto de información de formulario especificado. Si es necesario, CreateForm llama al método IMAPIFormMgr::P repareForm para descargar el código del servidor de formulario en el disco del usuario.
El parámetro pfrminfoToActivate debe apuntar a un objeto de información de formulario que se haya resuelto correctamente.
Una vez abierto el formulario, el visor de formularios que realiza la llamada debe configurar un mensaje mediante la interfaz IPersistMessage y, opcionalmente, puede configurar un contexto de vista para el formulario. Para obtener más información, vea Iniciar un servidor de formularios.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MAPIFormFunctions.cpp |
CreateAndDisplayNewMailInFolder |
MFCMAPI usa el método IMAPIFormMgr::CreateForm para crear un formulario antes de mostrarlo. |