Leer en inglés

Compartir a través de


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.

Vea también

IMAPIFolder::SetMessageStatus

IMAPISession::ShowForm

Propiedad canónica PidTagMessageStatus

IMAPIFolder : IMAPIContainer

MFCMAPI como un ejemplo de c�digo