Compartilhar via


IMAPISupport::ExpandRecips

Aplica-se a: Outlook 2013 | Outlook 2016

Conclui a lista de destinatários de uma mensagem, expandindo listas de distribuição específicas.

HRESULT ExpandRecips(
  LPMESSAGE lpMessage,
  ULONG FAR * lpulFlags
);

Parâmetros

Lpmessage

[in] Um ponteiro para a mensagem que tem a lista de destinatários a ser processada.

lpulFlags

[out] Um ponteiro para um bitmask de sinalizadores que controla o tipo de processamento que ocorre. Os seguintes sinalizadores podem ser definidos:

NEEDS_PREPROCESSING

A mensagem precisa ser pré-processada antes de ser enviada.

NEEDS_SPOOLER

O spooler MAPI (em vez do provedor de transporte para o qual o chamador está fortemente acoplado) deve enviar a mensagem.

Valor de retorno

S_OK

A lista de destinatários da mensagem foi processada com êxito.

Comentários

O método IMAPISupport::ExpandRecips é implementado para objetos de suporte do provedor do repositório de mensagens. Os provedores do repositório de mensagens chamam ExpandRecips para solicitar ao MAPI que execute as seguintes tarefas:

  • Expanda determinadas listas de distribuição pessoal para seus destinatários de componentes.

  • Substitua todos os nomes de exibição que foram alterados pelos nomes originais.

  • Marque todas as entradas duplicadas.

  • Resolva todos os endereços pontuais.

  • Verifique se a mensagem precisa de pré-processamento e, se isso acontecer, defina o sinalizador apontado por lpulFlags como NEEDS_PREPROCESSING.

ExpandRecips expande todas as listas de distribuição que tenham o tipo de endereço de mensagens MAPIPDL.

Notas para chamadores

Sempre chame ExpandRecips como parte do processamento de mensagens. Faça uma chamada para ExpandRecips uma das primeiras chamadas na implementação do método IMessage::SubmitMessage .

Confira também

IMessage::SubmitMessage

IMAPISupport: IUnknown