IMAPIMessageSite::NewMessage
Hace referencia a: Outlook 2013 | Outlook 2016
Crea un nuevo mensaje.
HRESULT NewMessage(
ULONG fComposeInFolder,
LPMAPIFOLDER pFolderFocus,
LPPERSISTMESSAGE pPersistMessage,
LPMESSAGE FAR * ppMessage,
LPMAPIMESSAGESITE FAR * ppMessageSite,
LPMAPIVIEWCONTEXT FAR * ppViewContext
);
Parameters
fComposeInFolder
[in] Indica en qué carpeta se debe componer el mensaje. Si la variable es FALSE, se omite el parámetro pFolderFocus y el visor de formularios puede redactar el mensaje en cualquier carpeta. Si la variable es TRUE y NULL se pasa en el parámetro pFolderFocus , el mensaje se compone en la carpeta actual. Si la variable es TRUE y se pasa un valor distinto de NULL en pFolderFocus, el mensaje se compone en la carpeta a la que apunta pFolderFocus.
pFolderFocus
[in] Puntero a la carpeta donde se crea el nuevo mensaje.
pPersistMessage
[in] Puntero al objeto de formulario para el nuevo formulario.
ppMessage
[out] Puntero a un puntero al nuevo mensaje.
ppMessageSite
[out] Puntero a un puntero a un objeto de sitio de mensaje para el nuevo mensaje.
ppViewContext
[out] Puntero a un puntero a un contexto de vista adecuado para pasar a un nuevo formulario con el nuevo mensaje. Si el formulario implementa su propio contexto de vista, se puede pasar NULL en el parámetro ppViewContext .
Valor devuelto
S_OK
La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.
Comentarios
Los objetos Form llaman al método IMAPIMessageSite::NewMessage para crear un mensaje. El formulario usa NewMessage para obtener un nuevo mensaje y el sitio de mensaje asociado desde su vista. A continuación, puede modificar el nuevo mensaje.
También puede obtener un contexto de vista asociado pasando un valor distinto de NULL en el parámetro ppViewContext . Este contexto de vista se puede usar directamente o se puede agregar y pasar al nuevo mensaje. Si se requiere una implementación completa, pase NULL en ppViewContext.
Para obtener una lista de interfaces relacionadas con los servidores de formularios, vea Interfaces de formulario MAPI.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::NewMessage |
MFCMAPI usa el método IMAPIMessageSite::NewMessage para crear un mensaje, crear una instancia de un nuevo visor de formularios y llamar a SetPersist para establecer el mensaje en el visor de formularios. Por último, devuelve el visor de formularios como el sitio del mensaje. |