IMAPISupport::StatusRecips
Aplica-se a: Outlook 2013 | Outlook 2016
Gera relatórios de entrega e não informações.
HRESULT StatusRecips(
LPMESSAGE lpMessage,
LPADRLIST lpRecipList
);
Parâmetros
Lpmessage
[in] Um ponteiro para a mensagem para a qual o relatório deve ser gerado.
lpRecipList
[in] Um ponteiro para uma estrutura ADRLIST que descreve os destinatários da mensagem apontada por lpMessage.
Valor de retorno
S_OK
O relatório foi gerado com êxito.
MAPI_W_ERRORS_RETURNED
A chamada foi bem-sucedida no geral, mas não há opções de destinatário para esse tipo de destinatário. Quando esse aviso é retornado, a chamada deve ser tratada como bem-sucedida. Para testar esse aviso, use a macro HR_FAILED . Para obter mais informações, confira Usando macros para tratamento de erros.
Comentários
O método IMAPISupport::StatusRecips é implementado para objetos de suporte do provedor de transporte. Os provedores de transporte chamam StatusRecips para solicitar que o MAPI envie um relatório de entrega ou não de entrega para um conjunto de um ou mais destinatários de uma mensagem.
Notas para chamadores
Você pode chamar StatusRecips várias vezes durante o processamento de uma mensagem. No entanto, se você chamar StatusRecips para uma mensagem aberta, faça o seu melhor para coletar todas as informações de entrega e não conformidade para os destinatários da mensagem e chamar StatusRecips para essa lista de destinatários. Um único ponto de coleção é importante, pois várias chamadas statusRecips para um destinatário podem resultar em vários relatórios idênticos sendo enviados.
Armazene propriedades relacionadas à entrega de mensagens ou não na estrutura ADRLIST indicada pelo parâmetro lpRecipList . Para obter uma lista completa de propriedades necessárias e opcionais para relatórios de entrega e relatórios não detalhados, consulte Propriedades de mensagem de relatório necessárias e propriedades opcionais de mensagem de relatório.
Alocar memória para a estrutura ADRLIST em lpRecipList usando as funções MAPIAllocateBuffer e MAPIAllocateMore . O MAPI libera a memória chamando a função MAPIFreeBuffer somente se StatusRecips for bem-sucedido.
Para obter uma visão geral dos relatórios de entrega e não informações, consulte Mensagens de Relatório MAPI.