Propriedade Canônica PidTagInstanceKey
Aplica-se a: Outlook 2013 | Outlook 2016
Contém um valor que identifica exclusivamente uma linha em uma tabela.
| Propriedade | Valor |
|---|---|
| Propriedades associadas: |
PR_INSTANCE_KEY |
| Identificador: |
0x0FF6 |
| Tipo de dados: |
PT_BINARY |
| Área: |
Tabela |
Comentários
Essa propriedade é um valor binário que identifica exclusivamente uma linha em uma exibição de tabela. É uma coluna necessária na maioria das tabelas. Se uma linha for incluída em duas exibições, haverá duas chaves de instância diferentes. A chave de instância de uma linha pode ser diferente sempre que a tabela é aberta, mas permanece constante enquanto a tabela está aberta. As linhas adicionadas enquanto uma tabela está em uso não reutilizam uma chave de instância que foi usada anteriormente.
Use as propriedades PR_ENTRYID (PidTagEntryId) ou PR_RECORD_KEY (PidTagRecordKey) para correlacionar todas as linhas de uma expansão. Use PR_INSTANCE_KEY para localizar uma instância específica na expansão.
Quando uma propriedade multivalued é expandida em uma tabela, uma linha é criada para cada instância da expansão, ou seja, para cada valor dessa propriedade. Cada linha tem um valor exclusivo para a propriedade PR_INSTANCE_KEY , enquanto todas as outras colunas mantêm seus valores originais durante toda a expansão.
Em um tipo categorizado de uma tabela, linhas não correspondentes a dados reais podem ser adicionadas ao resultado do tipo. Cada linha desse tipo, como todas as linhas em todas as tabelas, tem sua própria chave de instância exclusiva.
PR_INSTANCE_KEY também é usado em notificações de evento de tabela. Os membros propIndex e propPrior da estrutura TABLE_NOTIFICATION são estruturas SPropValue com valores PR_INSTANCE_KEY . O membro propIndex indica a linha que foi adicionada ou alterada. O membro propPrior indica a linha antes da linha adicionada ou alterada (PR_NULL indica uma alteração na primeira linha).
Esse valor não é copiado como parte da tabela de exibição.
PR_INSTANCE_KEY é uma estrutura MAPIUID . Todas as chaves de instância podem ser comparadas diretamente como valores binários.
Recursos relacionados
Especificações de protocolo
Fornece referências às especificações de protocolo Exchange Server relacionadas.
Especifica as propriedades e as operações para listas de usuários, contatos, grupos e recursos.
Arquivos de cabeçalho
Mapidefs.h
Fornece definições de tipo de dados.
Mapitags.h
Contém definições de propriedades listadas como nomes alternativos.