Propriedade Canônica PidTagSearchKey

Artigo
03/18/2024

Aplica-se a: Outlook 2013 | Outlook 2016

Contém uma chave binária comparável que identifica objetos correlacionados para uma pesquisa.

Propriedade	Valor
Propriedades associadas:	PR_SEARCH_KEY
Identificador:	0x300B
Tipo de dados:	PT_BINARY
Área:	Propriedades de ID

Comentários

Essa propriedade fornece um rastreamento para objetos relacionados, como cópias de mensagens, e facilita a localização de ocorrências indesejadas, como destinatários duplicados.

O MAPI usa regras específicas para construir chaves de pesquisa para destinatários de mensagens. A chave de pesquisa é formada concatenando o tipo de endereço (em caracteres maiúsculas), o caractere colon ':', o endereço de email em forma canônica e o caractere nulo terminando. O formulário canônico aqui significa que os endereços sensíveis a casos aparecem no caso correto e os endereços que não são sensíveis a casos são convertidos em maiúsculas. Isso é importante na preservação de correlações entre mensagens.

Para objetos de mensagem, essa propriedade está disponível por meio do método IMAPIProp::GetProps imediatamente após a criação da mensagem. Para outros objetos, ele está disponível após a primeira chamada para o método IMAPIProp::SaveChanges . Como essa propriedade é alterável, não é confiável obtê-la por meio do GetProps até que uma chamada SaveChanges tenha confirmado todos os valores definidos ou alterados pelo método IMAPIProp::SetProps .

Para perfis, a MAPI também fornece uma seção de perfil codificado com código rígido chamada MUID_PROFILE_INSTANCE, com essa propriedade como sua propriedade única. Essa chave tem a garantia de ser exclusiva entre todos os perfis já criados e pode ser mais confiável do que a propriedade PR_PROFILE_NAME (PidTagProfileName), que pode ser, por exemplo, excluída e recriada com o mesmo nome.

A tabela a seguir resume diferenças importantes entre o PR_ENTRYID (PidTagEntryId), PR_RECORD_KEY (PidTagRecordKey) e essa propriedade.

Característica	PR_ENTRYID	PR_RECORD_KEY	PR_SEARCH_KEY
Necessário em objetos de anexo	Não	Sim	Não
Necessário em objetos de pasta	Sim	Sim	Não
Necessário em objetos do repositório de mensagens	Sim	Sim	Não
Necessário em objetos status	Sim	Não	Não
Creatável por cliente	Não	Não	Sim
Disponível antes do SaveChanges	Depende da implementação do provedor	Depende da implementação do provedor	Para mensagens, sim. Para outros, depende da implementação do provedor.
Alterado em uma operação de cópia	Sim	Sim	Não
Alterável por cliente após uma cópia	Não	Não	Sim
Exclusivo dentro de ...	Mundo inteiro	Instância do provedor	Mundo inteiro
Binário comparável (como com o memcmp)	Não -- use IMAPISupport::CompareEntryIDs	Sim	Sim