IPersistMessage::Load

Artículo
04/04/2023

Hace referencia a: Outlook 2013 | Outlook 2016

Carga el formulario de un mensaje especificado.

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

Parameters

pMessageSite

[in] Puntero al sitio del mensaje para que se cargue el formulario.

pMessage

[in] Puntero al mensaje para el que se debe cargar el formulario.

ulMessageStatus

[in] Máscara de bits de marcas definidas por el cliente o definidas por el proveedor, copiadas de la propiedad PR_MSG_STATUS del mensaje (PidTagMessageStatus) que proporcionan información sobre el estado del mensaje.

ulMessageFlags

[in] Máscara de bits de marcas, copiada de la propiedad PR_MESSAGE_FLAGS (PidTagMessageFlags) del mensaje, que proporciona más información sobre el estado del mensaje.

Valor devuelto

S_OK

El formulario se cargó correctamente.

Comentarios

Los visores de formularios llaman al método IPersistMessage::Load para cargar un formulario para un mensaje existente.

Notas a los implementadores

Solo se llama a load cuando un formulario se encuentra en uno de los siguientes estados:

Si un visor de formularios llama a Load mientras el formulario está en cualquier otro estado, el método devuelve E_UNEXPECTED.

Si el formulario tiene una referencia a un sitio de mensaje activo distinto del que se pasa a Carga, libere el sitio original porque ya no se usará. Almacene los punteros al sitio del mensaje y al mensaje desde los parámetros pMessageSite y pMessage y llame a los métodos IUnknown::AddRef de ambos objetos para incrementar sus recuentos de referencias.

Una vez completado AddRef , almacene las propiedades de los parámetros ulMessageStatus y ulMessageFlags en el formulario. Pase el formulario a su estado Normal antes de mostrarlo y notifique a los visores registrados llamando a sus métodos IMAPIViewAdviseSink::OnNewMessage .

Si no se produce ningún error, devuelva S_OK.