IMAPIMessageSite::GetSiteStatus
Область применения: Outlook 2013 | Outlook 2016
Возвращает сведения из объекта сайта сообщений о возможностях сайта сообщений для текущего сообщения.
HRESULT GetSiteStatus(
ULONG FAR * lpulStatus
);
Параметры
lpulStatus
[out] Указатель на битовую маску флагов, которая предоставляет сведения о состоянии сообщения. Можно задать следующие флаги:
VCSTATUS_COPY
Сообщение можно скопировать.
VCSTATUS_DELETE
Сообщение можно удалить.
VCSTATUS_DELETE_IS_MOVE
При удалении сообщение перемещается в папку "Удаленные" в хранилище сообщений, а не сразу удаляется из хранилища сообщений.
VCSTATUS_MOVE
Сообщение можно переместить.
VCSTATUS_NEW_MESSAGE
Можно создать новое сообщение.
VCSTATUS_SAVE
Сообщение можно сохранить.
VCSTATUS_SUBMIT
Сообщение можно отправить.
Возвращаемое значение
S_OK
����� ������� � ������ ��������� ��������� ��� ��������.
Замечания
Объекты формы вызывают метод IMAPIMessageSite::GetSiteStatus , чтобы получить возможности объекта сайта сообщения для текущего сообщения. Флаги, возвращаемые в параметре lpulStatus, предоставляют сведения о сайте сообщения. Как правило, форма включает или отключает команды меню в зависимости от сведений, предоставляемых флагами о возможностях реализации сайта сообщений. Если новое сообщение загружается в форму методом IPersistMessage::SaveCompleted или методом IPersistMessage::Load , необходимо проверить флаги состояния. Некоторые объекты сайта сообщений, особенно объекты, доступные только для чтения, не позволяют сохранять или удалять сообщения.
Примечания для исполнителей
Метод IMAPIMessageSite::GetSiteStatus может потребовать, чтобы клиентское приложение выполнило некоторые вычисления, чтобы определить, какие операции можно выполнить с текущим сообщением. Как правило, это включает в себя просмотр строки состояния для поставщика хранилища сообщений текущего сообщения или запрос к поставщику хранилища, чтобы определить, какие действия клиентское приложение может выполнять с помощью хранилища сообщений. Например, чтобы определить, следует ли возвращать флаг MAPI_DELETE_IS_MOVE, проверка свойство PR_IPM_WASTEBASKET_ENTRYID объекта хранилища сообщений (PidTagIpmWastebasketEntryId), чтобы узнать, есть ли в хранилище сообщений папка "Удаленные".
Список интерфейсов, связанных с серверами форм, см. в разделе Интерфейсы формы MAPI.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::GetSiteStatus |
MFCMAPI использует метод IMAPIMessageSite::GetSiteStatus для получения состояния указанного сайта. Он может возвращать VCSTATUS_NEW_MESSAGE, VCSTATUS_SAVE или VCSTATUS_SUBMIT. |
См. также
IPersistMessage::SaveCompleted