IMsgStore::SetLockState
Hace referencia a: Outlook 2013 | Outlook 2016
Bloquea o desbloquea un mensaje. Se llama a este m�todo s�lo por la cola MAPI.
HRESULT SetLockState(
LPMESSAGE lpMessage,
ULONG ulLockState
);
Parameters
lpMessage
[in] Puntero al mensaje que se va a bloquear o desbloquear.
ulLockState
[in] Valor que indica si el mensaje debe bloquearse o desbloquearse. Uno de los siguientes valores es válido:
MSG_LOCKED
El mensaje debe estar bloqueado.
MSG_UNLOCKED
El mensaje debe desbloquearse.
Valor devuelto
S_OK
El estado de bloqueo del mensaje se estableció correctamente.
Comentarios
El método IMsgStore::SetLockState bloquea o desbloquea un mensaje. SetLockState solo se puede llamar mediante la cola MAPI mientras envía el mensaje.
Normalmente, cuando el colador MAPI llama a SetLockState para bloquear un mensaje, bloquea solo el mensaje más antiguo (es decir, el siguiente mensaje en cola para que se envíe la cola MAPI). Si el mensaje más antiguo de la cola está esperando un proveedor de transporte temporalmente no disponible y el siguiente mensaje de la cola usa un proveedor de transporte diferente, la cola MAPI puede empezar a procesar el mensaje posterior. Comienza el procesamiento mediante el bloqueo de ese mensaje mediante SetLockState.
Notas a los implementadores
Después de que la cola MAPI haya llamado a SetLockState con el parámetro ulLockState establecido en MSG_LOCKED, las llamadas al método IMsgStore::AbortSubmit para cancelar la transmisión del mensaje deben producir un error.
Llame al método IMAPIProp::SaveChanges del mensaje en la implementación de SetLockState para que se guarden los cambios realizados en el mensaje antes de recibir la llamada a SetLockState .