IMAPIMessageSite::NewMessage
Область применения: Outlook 2013 | Outlook 2016
Создает новое сообщение.
HRESULT NewMessage(
ULONG fComposeInFolder,
LPMAPIFOLDER pFolderFocus,
LPPERSISTMESSAGE pPersistMessage,
LPMESSAGE FAR * ppMessage,
LPMAPIMESSAGESITE FAR * ppMessageSite,
LPMAPIVIEWCONTEXT FAR * ppViewContext
);
Параметры
fComposeInFolder
[в] Указывает, в какой папке должно быть составлено сообщение. Если переменная имеет значение FALSE, параметр pFolderFocus игнорируется, а средство просмотра форм может создать сообщение в любой папке. Если переменная имеет значение TRUE и значение NULL передается в параметре pFolderFocus , сообщение создается в текущей папке. Если переменная имеет значение TRUE и в pFolderFocus передается значение, отличное от NULL, сообщение создается в папке, на которую указывает pFolderFocus.
pFolderFocus
[в] Указатель на папку, в которой создается новое сообщение.
pPersistMessage
[в] Указатель на объект формы для новой формы.
ppMessage
[out] Указатель на указатель на новое сообщение.
ppMessageSite
[out] Указатель на указатель на объект сайта сообщения для нового сообщения.
ppViewContext
[out] Указатель на указатель на контекст представления, подходящий для передачи в новую форму с новым сообщением. Если форма реализует собственный контекст представления, в параметре ppViewContext можно передать значение NULL.
Возвращаемое значение
S_OK
����� ������� � ������ ��������� ��������� ��� ��������.
Замечания
Объекты формы вызывают метод IMAPIMessageSite::NewMessage для создания нового сообщения. Форма использует NewMessage для получения нового сообщения и связанного с ним сайта сообщения из представления. Затем он может изменить новое сообщение.
Вы также можете получить связанный контекст представления, передав значение, отличное от NULL, в параметре ppViewContext . Этот контекст представления можно использовать напрямую или его можно агрегировать и передать в новое сообщение. Если требуется полная реализация, передайте null в ppViewContext.
Список интерфейсов, связанных с серверами форм, см. в разделе Интерфейсы формы MAPI.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::NewMessage |
MFCMAPI использует метод IMAPIMessageSite::NewMessage для создания нового сообщения, создания экземпляра нового средства просмотра форм и вызова SetPersist , чтобы задать сообщение в средстве просмотра форм. Наконец, он возвращает средство просмотра формы в качестве сайта сообщения. |