Endereços únicos
Aplica-se a: Outlook 2013 | Outlook 2016
Endereços pontuais são usados para enviar mensagens para destinatários pontuais, destinatários que não têm uma entrada correspondente em nenhum dos contêineres do catálogo de endereços da sessão. Os clientes podem criar endereços pontuais quando adicionam novas entradas ao catálogo de endereços ou novos destinatários à lista de destinatários de uma mensagem de saída. Endereços pontuais podem ser adicionados a qualquer contêiner que seja modificável.
Para criar um endereço único, os clientes usam um modelo especial que contém controles de edição para inserir todas as informações que compõem um endereço único. Endereços pontuais, como endereços de outros tipos, usam um formato predefinido. O formato de endereço único é definido pelo MAPI da seguinte maneira:
Display name[Address type:Email address]
Há seis componentes nesse formato e algumas regras sobre como citar caracteres. Os componentes são descritos na tabela a seguir.
| Componente | Uso | Descrição |
|---|---|---|
| Nome de exibição |
Opcional |
Se não estiver presente, IAddrBook::ResolveName usará a parte visível do endereço de email como o nome de exibição. Pode incluir espaços em branco. Para obter mais informações, consulte IAddrBook::ResolveName. |
| [ |
Obrigatório |
Delineia o início das informações de tipo e endereço. |
| ] |
Obrigatório |
Delineia o fim das informações de tipo e endereço. Se algo diferente de espaço em branco seguir esse caractere, a entrada não será tratada como um destinatário personalizado. |
| Tipo de endereço |
Obrigatório |
Tipo de endereço; mapeia para um formato de endereço específico. Para obter mais informações, consulte Tipos de Endereço MAPI. |
| : |
Obrigatório |
Separa o tipo de endereço do endereço de email. |
| Endereço de email |
Obrigatório |
Endereço do destinatário. Pode incluir espaços em branco. |
O MAPI usa conjuntos específicos de caracteres de citação para permitir que os endereços contenham caracteres especiais, como vírgula (,), colchete esquerdo ([) e cólon (:) e alguns caracteres intipáveis, como o retorno do carro ou o feed de linha ou qualquer outro equivalente hexadecimal. O caractere de citação é o backslash (). Portanto, se os clientes ou provedores precisarem inserir um backslash em um endereço, eles deverão preceí-lo com o caractere de citação ("\").
Clientes e provedores de serviços podem usar essa técnica de citação em qualquer um dos campos não fixados e tipáveis. Por exemplo, a entrada a seguir se traduz em Bill Lee como o nome de exibição, MSPEER como o tipo de endereço e \billll\in como o endereço de email:
Bill Lee[MSPEER:\\\\billl\in]
Para inserir caracteres especiais não tipáveis, clientes e provedores de serviços usam um caractere de citação seguido por um x e dois dígitos hexadecimal para representar seu equivalente hexadecimal. Por exemplo, se um endereço tiver um caractere não tipável que equivale a um retorno de carro, (\0d) em hexadecimal, um cliente os inserirá como:
Fax Recipient[fax:recipient\x0dbuilding\x0doffice\x0d555-1212\x0d]
IAddrBook::ResolveName também analisa automaticamente a maioria dos endereços SMTP, procurando endereços com o seguinte formato:
XXX@YYY.ZZZ
Embora nem todos os possíveis formatos RFC822 sejam tratados, essa análise automática é adequada para a maioria dos usuários. ResolveName inclui essa funcionalidade para permitir que os usuários insiram endereços SMTP diretamente em uma mensagem e que essa mensagem vá para o usuário da Internet. Os componentes XXX, YYY e ZZZ do endereço podem ser um ou mais caracteres. Os componentes de endereço em sinal (@) não podem ser incluídos nos componentes de endereço XXX, YYY ou ZZZ e o componente YYY também não pode incluir o período. Como os caracteres a seguir são caracteres especiais em endereços SMTP, o MAPI converte automaticamente um nome de exibição que contém esses caracteres em um endereço único:
>>
@
<>
.
Cada endereço único recebe um identificador de entrada único correspondente. Para fazer essa atribuição, os clientes chamam IAddrBook::CreateOneOff e os provedores de transporte chamam IMAPISupport::CreateOneOff. Para obter mais informações, consulte IAddrBook::CreateOneOff e IMAPISupport::CreateOneOff. Ao processar mensagens de entrada, os provedores de transporte criam identificadores de entrada únicos para endereços de gateway e para endereços que não podem ser tratados pelos provedores de catálogo de endereços associados do transporte. Os provedores de transporte marcar o tipo de cada endereço em uma mensagem para determinar se ele pode ser manipulado por um provedor de catálogo de endereços associado ao transporte. Se não puder, os provedores de transporte chamarão IMAPISupport::CreateOneOff para associar o endereço a um identificador de entrada único.
Os identificadores de entrada pontuais incluem as seguintes informações na seguinte ordem:
MAPIUID
Versão
Sinalizadores
Nome de exibição
Tipo de endereço
Endereço de email
Nas chamadas para IAddrBook::CreateOneOff e IMAPISupport::CreateOneOff, clientes e provedores de transporte podem definir um sinalizador que indica se o destinatário representado ou não pelo endereço único pode processar objetos OLE formatados ou inseridos. Para indicar que um destinatário pode lidar com objetos OLE e texto formatados, clientes e provedores de transporte definem o sinalizador MAPI_SEND_NO_RICH_INFO no parâmetro ulFlags . MAPI então define a propriedade PR_SEND_RICH_INFO (PidTagSendRichInfo) do destinatário como FALSE. Quando esse sinalizador não é definido, o MAPI define PR_SEND_RICH_INFO como TRUE, a menos que o endereço único seja interpretado como um endereço SMTP. Nesse caso, PR_SEND_RICH_INFO padrão para FALSE.