ITnef::EncodeRecips
Aplica-se a: Outlook 2013 | Outlook 2016
Codifica uma exibição para a tabela de destinatário de uma mensagem no fluxo de dados TNEF (Formato de Encapsulamento Transport-Neutral) para a mensagem.
HRESULT EncodeRecips(
ULONG ulFlags,
LPMAPITABLE lpRecipientTable
);
Parâmetros
ulFlags
[in] Reservados; deve ser zero.
lpRecipientTable
[in] Um ponteiro para a tabela de destinatário para a qual a exibição está codificada. O parâmetro lpRecipientTable pode ser NULL.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
Comentários
Provedores de transporte, provedores de armazenamento de mensagens e gateways chamam o método ITnef::EncodeRecips para executar a codificação TNEF para uma exibição de tabela de destinatário específica. A codificação TNEF será útil, por exemplo, se um provedor ou gateway exigir um determinado conjunto de colunas, ordem de classificação ou restrição para a tabela do destinatário.
Um provedor ou gateway passa o modo de exibição de tabela a ser codificado no parâmetro lpRecipientTable . A implementação do TNEF codifica a tabela do destinatário com o modo de exibição fornecido, usando o conjunto de colunas, a ordem de classificação, a restrição e a posição. Se um provedor ou gateway passar NULL no lpRecipientTable, o TNEF obterá a tabela do destinatário da mensagem que está sendo codificada usando o método IMessage::GetRecipientTable e processará todas as linhas da tabela no fluxo TNEF usando as configurações atuais da tabela.
Chamar EncodeRecips com NULL em lpRecipientTable codifica assim todos os destinatários de mensagens e é equivalente a chamar o método ITnef::AddProps com o sinalizador TNEF_PROP_INCLUDE em seu parâmetro ulFlags e a propriedade PR_MESSAGE_RECIPIENTS (PidTagMessageRecipients) em seu parâmetro lpPropList .
Observe que raramente é necessário chamar EncodeRecips , a menos que haja um requisito para codificar uma exibição de tabela de destinatário específica. Os sistemas de mensagens estrangeiros quase sempre têm facilidades para lidar com listas de destinatários que são poderosas o suficiente para lidar com as necessidades comuns de codificação de listas de destinatários; Portanto, esses sistemas quase nunca exigem TNEF para essa finalidade.