IMAPIFolder::CreateMessage
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
9/8/2008
The CreateMessage método cria uma nova mensagem dentro de atual pasta.
Syntax
HRESULT CreateMessage (
LPCIID lpInterface,
ULONG ulFlags,
LPMESSAGE FAR * lppMessage
);
Parameters
- lpInterface
[no] Deve ser NULL.
- ulFlags
[no] Deve ser zero.
- lppMessage
[out] Referência para a mensagem recém-criada, implementada em IMessage.
Return Value
This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED GPSGetPosition, e E_FAIL, as well as o seguinte.
- S_OK
Indica sucesso.
Remarks
CreateMessage Cria uma nova mensagem com genérico ou associado de conteúdo e atribui um identificador entrada. O identificador entrada é composta de uma parte que representa o provedor armazenar mensagem e uma parte que representa o individual mensagem.
The lppMessage deve ser lançado para limpar a memória alocada.
É o identificador entrada da mensagem nova disponível imediatamente após CreateMessage Retorna.
Esperado o identificador entrada atribuída à nova mensagem ser exclusivo dentro de atual armazenar mensagem tão bem como para todos os armazenamentos mensagem que são aberto simultaneamente. Ocorre uma exceção a essa regra geral quando múltiplo entradas para armazenar uma mensagem constar o perfil, causando a armazenar mensagem seja aberto múltiplo horários e identificadores entrada a ser duplicado.
Para criar uma de saída mensagem, do chamar a pasta Caixa de saída CreateMessage método). Em seguida, chamar IMessage::SubmitMessage na verdade enviar a mensagem.
Se você excluir uma pasta que contém uma nova mensagem antes de mensagem é salva, os resultados são indefinido.
Requirements
| Header | mapidefs.h |
| Library | cemapi.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Pocket PC 2002 and later, Smartphone 2002 and later |