Identificadores de entradas únicas
Aplica-se a: Outlook 2013 | Outlook 2016
Identificadores de entrada únicos são criados pelo MAPI no método IAddrBook::CreateOneOff e por componentes que não têm acesso ao subsistema MAPI, como componentes de gateway. Para obter mais informações, consulte IAddrBook::CreateOneOff. A ilustração a seguir mostra o formato de um identificador de entrada único.
One-off entry identifier format
única
O primeiro campo é uma estrutura MAPIUID especial que identifica o identificador de entrada como representando um destinatário personalizado. Essa estrutura MAPIUID deve ser definida como a MAPI_ONE_OFF_UID constante. MAPI_ONE_OFF_UID é definido no arquivo de cabeçalho MAPIDEFS.H.
Os campos de versão e sinalizadores são palavras de 16 bits na ordem de byte do Intel. O campo de versão deve ser definido como zero. O campo sinalizadores pode ser definido como os seguintes valores:
MAPI_ONE_OFF_NO_RICH_INFO
MAPI_ONE_OFF_UNICODE
O sinalizador MAPI_ONE_OFF_NO_RICH_INFO será definido se um destinatário não receber conteúdo de mensagem no TNEF (Formato de Encapsulamento Neutro de Transporte). Esse sinalizador é definido quando MAPI_SEND_NO_RICH_INFO é passado para o método IAddrBook::CreateOneOff .
O sinalizador MAPI_ONE_OFF_UNICODE será definido se o nome de exibição e o endereço de email forem cadeias de caracteres Unicode. Esse sinalizador é definido quando o MAPI_UNICODE é passado para IAddrBook::CreateOneOff. Quando o sinalizador MAPI_UNICODE não é passado para CreateOneOff, MAPI pressupõe que o nome de exibição e as cadeias de endereços de email estão no conjunto de caracteres ANSI atual da estação de trabalho. As cadeias de caracteres ANSI geralmente não funcionam bem em mensagens enviadas entre plataformas usando conjuntos de caracteres diferentes porque a página de código não está codificada no identificador de entrada. Para proteger contra essa possível incompatibilidade, muitos tipos de endereço são limitados apenas aos caracteres comuns em vários conjuntos de caracteres. No entanto, para garantir o conjunto de caracteres e a compatibilidade com a plataforma, os clientes devem usar o Unicode para as cadeias de caracteres em suas mensagens.
O nome de exibição é uma cadeia de caracteres terminada nulo que corresponde à propriedade PR_DISPLAY_NAME do destinatário (PidTagDisplayName) e ao parâmetro lpszName passado para IAddrBook::CreateOneOff. O conjunto de caracteres será Unicode se o sinalizador MAPI_ONE_OFF_UNICODE estiver definido e ANSI se estiver claro.
O tipo de endereço é uma cadeia de caracteres terminada nulo que corresponde à propriedade PR_ADDRTYPE (PidTagAddressType) do destinatário e ao parâmetro lpszAdrType passado para IAddrBook::CreateOneOff.
O endereço de email é uma cadeia de caracteres terminada nulo que corresponde à propriedade pidTagEmailAddress (PR_EMAIL_ADDRESS do destinatário) e ao parâmetro lpszAddress passado para IAddrBook::CreateOneOff.
Observação
Não há preenchimento em estruturas de identificador de entrada pontuais; os bytes são empacotados exatamente como indicado acima e o comprimento do identificador de entrada não deve incluir nenhum bytes além do caractere nulo final do endereço de email.
Clientes e provedores de catálogo de endereços que constroem manualmente identificadores de entrada pontuais também podem precisar gerar valores para as propriedades PR_RECORD_KEY (PidTagRecordKey) e PR_SEARCH_KEY (PidTagSearchKey). A chave de registro é idêntica ao identificador de entrada. A chave de pesquisa deve ser formada ao concatenar os seguintes campos na seguinte ordem:
O tipo de endereço, convertido em caracteres maiúsculas.
Um cólon (:).
O endereço de email, convertido em caracteres maiúsculas.
Um caractere nulo que termina.
Nenhuma conversão de conjunto de caracteres deve ser feita ao gerar a chave de pesquisa.