IPersistMessage::Load

Статья
04/04/2023

Область применения: Outlook 2013 | Outlook 2016

Загружает форму для указанного сообщения.

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

Параметры

pMessageSite

[в] Указатель на сайт сообщений для загружаемой формы.

pMessage

[в] Указатель на сообщение, для которого должна быть загружена форма.

ulMessageStatus

[в] Битовая маска определенных клиентом или поставщиком флагов, скопированная из свойства PR_MSG_STATUS сообщения (PidTagMessageStatus), которая предоставляет сведения о состоянии сообщения.

ulMessageFlags

[в] Битовая маска флагов, скопированная из свойства PR_MESSAGE_FLAGS сообщения (PidTagMessageFlags), которая предоставляет дополнительные сведения о состоянии сообщения.

Возвращаемое значение

S_OK

Форма успешно загружена.

Замечания

Средства просмотра форм вызывают метод IPersistMessage::Load , чтобы загрузить форму для существующего сообщения.

Примечания для исполнителей

Загрузка вызывается только в том случае, если форма находится в одном из следующих состояний:

Если средство просмотра формы вызывает Load , пока форма находится в другом состоянии, метод возвращает E_UNEXPECTED.

Если форма содержит ссылку на активный сайт сообщений, отличный от того, который передается в load, отпустите исходный сайт, так как он больше не будет использоваться. Сохраните указатели на сайт сообщения и сообщение из параметров pMessageSite и pMessage и вызовите методы IUnknown::AddRef обоих объектов для увеличения количества ссылок.

После завершения addRef сохраните свойства из параметров ulMessageStatus и ulMessageFlags в форме. Перед отображением формы переведите форму в обычное состояние и уведомите зарегистрированных зрителей, вызвав методы IMAPIViewAdviseSink::OnNewMessage .

Если ошибок не возникает, верните S_OK.