IMsgStore::SetLockState
Область применения: Outlook 2013 | Outlook 2016
Блокирует или разблокирует сообщение. ���� ����� ���������� ������ ����������� ������� MAPI.
HRESULT SetLockState(
LPMESSAGE lpMessage,
ULONG ulLockState
);
Параметры
lpMessage
[в] Указатель на сообщение для блокировки или разблокировки.
ulLockState
[в] Значение типа , указывающее, должно ли сообщение быть заблокировано или разблокировано. Допустимо одно из следующих значений:
MSG_LOCKED
Сообщение должно быть заблокировано.
MSG_UNLOCKED
Сообщение должно быть разблокировано.
Возвращаемое значение
S_OK
Состояние блокировки сообщения успешно установлено.
Замечания
Метод IMsgStore::SetLockState блокирует или разблокирует сообщение. Метод SetLockState может вызываться только диспетчером очереди MAPI во время отправки сообщения.
Обычно, когда диспетчер очереди MAPI вызывает SetLockState для блокировки сообщения, он блокирует только самое старое сообщение (т. е. следующее сообщение, помещенное в очередь для отправки диспетчера очереди MAPI). Если самое старое сообщение в очереди ожидает временно недоступного поставщика транспорта, а следующее сообщение в очереди использует другой поставщик транспорта, диспетчер очереди может начать обработку последующего сообщения. Обработка начинается с блокировки сообщения с помощью SetLockState.
Примечания для исполнителей
После вызова диспетчера очереди MAPI SetLockState с параметром ulLockState , для которого задано значение MSG_LOCKED, вызовы метода IMsgStore::AbortSubmit для отмены передачи сообщения должны завершиться ошибкой.
Вызовите метод IMAPIProp::SaveChanges сообщения в реализации SetLockState , чтобы сохранить все изменения, внесенные в сообщение до получения вызова SetLockState .