IMAPIMessageSite::NewMessage
Aplica-se a: Outlook 2013 | Outlook 2016
Cria uma nova mensagem.
HRESULT NewMessage(
ULONG fComposeInFolder,
LPMAPIFOLDER pFolderFocus,
LPPERSISTMESSAGE pPersistMessage,
LPMESSAGE FAR * ppMessage,
LPMAPIMESSAGESITE FAR * ppMessageSite,
LPMAPIVIEWCONTEXT FAR * ppViewContext
);
Parâmetros
fComposeInFolder
[in] Indica em qual pasta a mensagem deve ser composta. Se a variável for FALSE, o parâmetro pFolderFocus será ignorado e o visualizador de formulários poderá compor a mensagem em qualquer pasta. Se a variável for TRUE e NULL for passada no parâmetro pFolderFocus , a mensagem será composta na pasta atual. Se a variável for TRUE e um valor não NULL for passado em pFolderFocus, a mensagem será composta na pasta apontada por pFolderFocus.
pFolderFocus
[in] Um ponteiro para a pasta em que a nova mensagem é criada.
pPersistMessage
[in] Um ponteiro para o objeto de formulário para o novo formulário.
ppMessage
[out] Um ponteiro para um ponteiro para a nova mensagem.
ppMessageSite
[out] Um ponteiro para um ponteiro para um objeto do site de mensagens para a nova mensagem.
ppViewContext
[out] Um ponteiro para um ponteiro para um contexto de exibição apropriado para passar para um novo formulário com a nova mensagem. Se o formulário implementar seu próprio contexto de exibição, NULL poderá ser passado no parâmetro ppViewContext .
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
Comentários
Os objetos de formulário chamam o método IMAPIMessageSite::NewMessage para criar uma nova mensagem. O formulário usa NewMessage para obter uma nova mensagem e o site de mensagens associado de sua exibição. Em seguida, ele pode modificar a nova mensagem.
Você também pode obter um contexto de exibição associado passando um valor não NULL no parâmetro ppViewContext . Esse contexto de exibição pode ser usado diretamente ou pode ser agregado e passado para a nova mensagem. Se uma implementação completa for necessária, passe NULL em ppViewContext.
Para obter uma lista de interfaces relacionadas a servidores de formulário, consulte Interfaces de Formulário MAPI.
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::NewMessage |
O MFCMAPI usa o método IMAPIMessageSite::NewMessage para criar uma nova mensagem, instanciar um novo visualizador de formulários e chamar SetPersist para definir a mensagem no visualizador de formulários. Por fim, ele retorna o visualizador de formulários como o site de mensagens. |