IPersistMessage::Load

Artigo
04/04/2023

Aplica-se a: Outlook 2013 | Outlook 2016

Carrega o formulário para uma mensagem especificada.

HRESULT Load(
  LPMESSAGESITE pMessageSite,
  LPMESSAGE pMessage,
  ULONG ulMessageStatus,
  ULONG ulMessageFlags
);

Parâmetros

pMessageSite

[in] Um ponteiro para o site de mensagens para que o formulário seja carregado.

pMessage

[in] Um ponteiro para a mensagem para a qual o formulário deve ser carregado.

ulMessageStatus

[in] Um bitmask de sinalizadores definidos pelo cliente ou definidos pelo provedor, copiados da propriedade PR_MSG_STATUS (PidTagMessageStatus) da mensagem, que fornecem informações sobre o estado da mensagem.

ulMessageFlags

[in] Um bitmask de sinalizadores, copiado da propriedade PR_MESSAGE_FLAGS (PidTagMessageFlags) da mensagem, que fornecem mais informações sobre o estado da mensagem.

Valor de retorno

S_OK

O formulário foi carregado com êxito.

Comentários

Os visualizadores de formulário chamam o método IPersistMessage::Load para carregar um formulário para uma mensagem existente.

Observações para implementadores

A carga é chamada somente quando um formulário está em um dos seguintes estados:

Se um visualizador de formulários chamar Carregar enquanto o formulário estiver em qualquer outro estado, o método retornará E_UNEXPECTED.

Se o formulário tiver uma referência a um site de mensagens ativo diferente daquele que é passado para Load, libere o site original porque ele não será mais usado. Armazene os ponteiros para o site de mensagens e a mensagem dos parâmetros pMessageSite e pMessage e chame os métodos IUnknown::AddRef de ambos os objetos para incrementar suas contagens de referência.

Depois que AddRef for concluído, armazene as propriedades dos parâmetros ulMessageStatus e ulMessageFlags no formulário. Faça a transição do formulário para seu estado normal antes de exibi-lo e notifique os espectadores registrados chamando seus métodos IMAPIViewAdviseSink::OnNewMessage .

Se não ocorrerem erros, retorne S_OK.