Compartilhar via

IMAPISupport::ReadReceipt

  • Artigo

Aplica-se a: Outlook 2013 | Outlook 2016

Gera um relatório de leitura ou não lido para uma mensagem.

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

Parâmetros

ulFlags

[in] Um bitmask de sinalizadores que controla como o relatório de leitura ou não lido é gerado. O seguinte sinalizador pode ser definido:

MAPI_NON_READ

Um relatório não lido é gerado. Se MAPI_NON_READ não estiver definido, um relatório de leitura será gerado.

lpReadMessage

[in] Um ponteiro para a mensagem sobre a qual o relatório deve ser gerado.

lppEmptyMessage

[in, out] Na entrada, lppEmptyMessage aponta para um ponteiro para uma mensagem vazia. Na saída, lppEmptyMessage aponta para um ponteiro para a mensagem de relatório.

Valor de retorno

S_OK

O relatório foi gerado com êxito.

Comentários

O método IMAPISupport::ReadReceipt é implementado apenas para objetos de suporte do provedor do repositório de mensagens. Os provedores do repositório de mensagens chamam ReadReceipt para instruir o MAPI a gerar um relatório de leitura ou não lido para a mensagem apontada pelo parâmetro lpReadMessage .

Notas para chamadores

Chame ReadReceipt quando a propriedade PR_READ_RECEIPT_REQUESTED (PidTagReadReceiptRequested) é definida e uma das seguintes condições é verdadeira:

  • A mensagem foi lida.
  • A mensagem foi movida.
  • A mensagem foi copiada.
  • O método IMessage::SetReadFlag da mensagem foi chamado.

Não chame ReadReceipt quando uma mensagem é excluída.

Um relatório de leitura ou não lido deve ser enviado apenas uma vez para uma mensagem. Acompanhe a leitura de uma mensagem status e não envie vários relatórios para uma única mensagem.

Se o parâmetro lppEmptyMessage apontar para uma mensagem de relatório válida quando MAPI retornar de ReadReceipt, chame o método IMessage::SubmitMessage para enviar a mensagem e solte o ponteiro chamando seu método IUnknown:s:Release .

Se ReadReceipt falhar, a mensagem deverá ser lançada sem ser enviada. Se você armazenar o status de leitura da mensagem, poderá tentar gerar o relatório de leitura ou não lido posteriormente.

Você pode ocultar ou exibir relatórios de leitura e não lidos gerados por repositórios em suas pastas. Armazenar relatórios de leitura e não lidos em pastas ocultas permite implementar uma segurança mais rigorosa.

Confira também

IMAPIFolder::DeleteMessages
IMessage::SubmitMessage
Propriedade Canônica PidTagReadReceiptRequested
IMAPISupport: IUnknown