IMAPIFolder::SetMessageStatus
Hace referencia a: Outlook 2013 | Outlook 2016
Establece el estado asociado a un mensaje (por ejemplo, si ese mensaje está marcado para su eliminación).
HRESULT SetMessageStatus(
ULONG cbEntryID,
LPENTRYID lpEntryID,
ULONG ulNewStatus,
ULONG ulNewStatusMask,
ULONG FAR * lpulOldStatus
);
Parameters
cbEntryID
[in] Recuento de bytes en el identificador de entrada al que apunta el parámetro lpEntryID .
lpEntryID
[in] Puntero al identificador de entrada del mensaje cuyo estado está establecido.
ulNewStatus
[in] Nuevo estado que se va a asignar.
ulNewStatusMask
[in] Máscara de bits de marcas que se aplica al nuevo estado e indica las marcas que se van a establecer. Se pueden establecer las siguientes marcas:
MSGSTATUS_DELMARKED
El mensaje se ha marcado para su eliminación.
MSGSTATUS_HIDDEN
El mensaje no se va a mostrar.
MSGSTATUS_HIGHLIGHTED
El mensaje se mostrará resaltado.
MSGSTATUS_REMOTE_DELETE
El mensaje se ha marcado para su eliminación en el almacén de mensajes remoto sin descargarlo en el cliente local.
MSGSTATUS_REMOTE_DOWNLOAD
El mensaje se ha marcado para su descarga desde el almacén de mensajes remoto al cliente local.
MSGSTATUS_TAGGED
El mensaje se ha etiquetado para un propósito definido por el cliente.
lpulOldStatus
[out] Puntero al estado anterior del mensaje.
Valor devuelto
S_OK
El estado del mensaje se ha establecido correctamente.
Comentarios
El método IMAPIFolder::SetMessageStatus establece el estado del mensaje en el valor almacenado en su propiedad PR_MSG_STATUS (PidTagMessageStatus).
Notas a los implementadores
La forma en que se establecen, borran y usan los bits de estado del mensaje depende completamente de la implementación, excepto que los bits del 0 al 15 están reservados y deben ser cero.
La implementación de este método por parte de un proveedor de transporte remoto debe seguir la semántica que se describe aquí. No hay consideraciones especiales. Los clientes usan este método para establecer los bits MSGSTATUS_REMOTE_DOWNLOAD y MSGSTATUS_REMOTE_DELETE para indicar que se va a descargar o eliminar un mensaje determinado del almacén de mensajes remoto. Un proveedor de transporte remoto no tiene que implementar el método IMAPIFolder::GetMessageStatus relacionado. Los clientes deben buscar en la tabla de contenido de la carpeta para determinar el estado de un mensaje.
Notas para los llamadores
Puede usar la propiedad PR_MSG_STATUS de un mensaje para negociar una operación de bloqueo de mensajes con otros clientes. Designe un bit como el bit de bloqueo. Para determinar si se estableció el bit de bloqueo, examine el valor anterior del estado del mensaje en el parámetro lpulOldStatus . Use los demás bits del parámetro ulNewStatus para realizar un seguimiento del estado del mensaje sin interferir con el bit de bloqueo.