IMAPIViewContext::GetSaveStream
Aplica-se a: Outlook 2013 | Outlook 2016
Recupera um fluxo a ser usado para salvar a mensagem atual.
HRESULT GetSaveStream(
ULONG FAR * pulFlags,
ULONG FAR * pulFormat,
LPSTREAM FAR * ppstm
);
Parâmetros
pulFlags
[out] Ponteiro para um bitmask de sinalizadores que controla como o texto da mensagem deve ser salvo. O seguinte sinalizador pode ser definido:
MAPI_UNICODE
O texto da mensagem é salvo no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, o texto será salvo no formato ANSI.
pulFormat
[out] Ponteiro para um bitmask de sinalizadores que controla o formato do texto salvo. Os seguintes sinalizadores podem ser definidos:
SAVE_FORMAT_RICHTEXT
O texto da mensagem deve ser salvo como texto formatado no RTF (Rich Text Format).
SAVE_FORMAT_TEXT
O texto da mensagem deve ser salvo como texto simples.
ppstm
[out] Ponteiro para um ponteiro para o fluxo que conterá a mensagem salva.
Valor de retorno
S_OK
O fluxo foi recuperado com êxito.
Comentários
Os objetos de formulário chamam o método IMAPIViewContext::GetSaveStream para recuperar um fluxo de um objeto que implementa a interface IStream para dar suporte ao tratamento do verbo Salvar como no visualizador de formulários. O método IMAPIForm::D oVerb , que é implementado no servidor de formulários e chamado pelo visualizador de formulários para invocar um verbo, não deve retornar até que a mensagem seja totalmente convertida no formato de texto apropriado e colocada no fluxo apropriado.
Notas para chamadores
Não escreva no fluxo apontado por ppstm antes de chamar GetSaveStream. Quando GetSaveStream retornar, não reinicie a posição do ponteiro de busca. Esse ponteiro deve permanecer no final do texto da mensagem salva.