Compartir a través de

IMAPISupport::ReadReceipt

  • Artículo

Hace referencia a: Outlook 2013 | Outlook 2016

Genera un informe de lectura o no leído para un mensaje.

HRESULT ReadReceipt(
ULONG ulFlags,
LPMESSAGE lpReadMessage,
LPMESSAGE FAR * lppEmptyMessage
);

Parameters

ulFlags

[in] Máscara de bits de marcas que controla cómo se genera el informe de lectura o no leído. Se puede establecer la marca siguiente:

MAPI_NON_READ

Se genera un informe no leído. Si no se establece MAPI_NON_READ, se genera un informe de lectura.

lpReadMessage

[in] Puntero al mensaje sobre el que se debe generar el informe.

lppEmptyMessage

[entrada, salida] En la entrada, lppEmptyMessage apunta a un puntero a un mensaje vacío. En la salida, lppEmptyMessage apunta a un puntero al mensaje del informe.

Valor devuelto

S_OK

El informe se generó correctamente.

Comentarios

El método IMAPISupport::ReadReceipt solo se implementa para los objetos de soporte técnico del proveedor de mensajes. Los proveedores de almacén de mensajes llaman a ReadReceipt para indicar a MAPI que genere un informe de lectura o no leído para el mensaje al que apunta el parámetro lpReadMessage .

Notas para los llamadores

Llame a ReadReceipt cuando se establece la propiedad PR_READ_RECEIPT_REQUESTED (PidTagReadReceiptRequested) y se cumple una de las condiciones siguientes:

  • El mensaje se ha leído.
  • El mensaje se ha movido.
  • El mensaje se ha copiado.
  • Se ha llamado al método IMessage::SetReadFlag del mensaje.

No llame a ReadReceipt cuando se elimine un mensaje.

Un informe de lectura o no leído solo se debe enviar una vez para un mensaje. Realice un seguimiento del estado de lectura de un mensaje y no envíe varios informes para un solo mensaje.

Si el parámetro lppEmptyMessage apunta a un mensaje de informe válido cuando MAPI devuelve desde ReadReceipt, llame al método IMessage::SubmitMessage para enviar el mensaje y, a continuación, libere el puntero llamando a su método IUnknown:s:Release .

Si se produce un error en ReadReceipt , el mensaje debe publicarse sin enviarse. Si almacena el estado de lectura del mensaje, puede intentar generar el informe de lectura o no leído más adelante.

Puede ocultar o mostrar informes de lectura y no leídos generados por almacenes en las carpetas. Almacenar informes de lectura y no leídos en carpetas ocultas le permite implementar una seguridad más estricta.

Vea también

IMAPIFolder::DeleteMessages
IMessage::SubmitMessage
Propiedad canónica PidTagReadReceiptRequested
IMAPISupport: IUnknown