IMAPIFolder::GetMessageStatus
Hace referencia a: Outlook 2013 | Outlook 2016
Obtiene el estado asociado a un mensaje en una carpeta determinada (por ejemplo, si ese mensaje está marcado para su eliminación).
HRESULT GetMessageStatus(
ULONG cbEntryID,
LPENTRYID lpEntryID,
ULONG ulFlags,
ULONG FAR * lpulMessageStatus
);
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 se obtiene.
ulFlags
[entrada] Reservado; debe ser cero.
lpulMessageStatus
[out] Puntero a un puntero a una máscara de bits de marcas que indican el estado del mensaje. Los bits 0 a 15 están reservados y deben ser cero; Los bits 16 a 31 están disponibles para su uso específico de la implementación. 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.
Valor devuelto
S_OK
El estado del mensaje se recuperó correctamente.
Comentarios
El método IMAPIFolder::GetMessageStatus devuelve el estado de un mensaje. El estado del mensaje se almacena en la propiedad PR_MSG_STATUS (PidTagMessageStatus) del mensaje.
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. Si almacena mensajes en el subárbol IPM, MAPI reserva los bits 16 a 31 para que los usen los clientes IPM. Si almacena mensajes en otros subárboles, puede usar los bits 16 a 31 para sus propios fines.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::GetNextMessage |
MFCMAPI usa el método IMAPIFolder::GetMessageStatus para obtener el estado del siguiente mensaje que se va a mostrar. |
| MAPIFormFunctions.cpp |
OpenMessageNonModal y OpenMessageModal |
MFCMAPI usa el método IMAPIFolder::GetMessageStatus para obtener el estado del mensaje que se va a mostrar para pasarlo al visor de formularios, que es CMyMAPIFormViewer o IMAPISession::ShowForm. |