Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a: Outlook 2013 | Outlook 2016
Identificadores de entrada são partes de dados binários armazenados em uma estrutura ENTRYID que são usados para identificar e abrir exclusivamente um objeto MAPI. A maioria dos objetos MAPI tem identificadores de entrada. Os identificadores de entrada para objetos são análogos aos nomes de arquivo para arquivos. No entanto, eles não são transmissíveis e não podem ser usados em sistemas diferentes do sistema em que se originaram.
Identificadores de entrada
Os provedores de repositório de mensagens atribuem identificadores de entrada a repositórios de mensagens, pastas e mensagens; Os provedores de catálogo de endereços os atribuem a contêineres de catálogo de endereços, listas de distribuição e usuários de mensagens. Os identificadores de entrada também são usados para abrir um objeto representado por uma linha em uma tabela, como um objeto de status na tabela de status. Os objetos armazenam seus identificadores de entrada em sua propriedade PR_ENTRYID (PidTagEntryId).
Enquanto os provedores de serviços criam, atribuem e examinam identificadores de entrada, os aplicativos cliente os usam apenas como ferramentas para abrir objetos. Para os clientes, os identificadores de entrada são partes opacas de dados binários e não têm nada a ver com o sistema de mensagens subjacente.
Os clientes chamam o método IMAPIProp::GetProps de um objeto para recuperar sua propriedade PR_ENTRYID ou o método IMAPITable::QueryColumns de uma tabela para recuperar a coluna que contém a propriedade PR_ENTRYID .
Os identificadores de entrada são passados como parâmetros para os métodos OpenEntry e CompareEntryIDs . Vários objetos MAPI implementam os métodos OpenEntry e CompareEntryIDs . Com o OpenEntry, os clientes podem abrir um objeto. Com CompareEntryIDs, os clientes podem comparar dois identificadores de entrada para determinar se eles se referem ao mesmo objeto. Como os identificadores de entrada não são necessariamente comparáveis em binários, os clientes devem compará-los pelo método CompareEntryIDs .
Os clientes devem sempre passar identificadores de entrada alinhados naturalmente em suas chamadas para provedores de serviços, pois, embora os provedores de serviços devam lidar com identificadores de entrada alinhados arbitrariamente, esse nem sempre é o caso. Um endereço de memória alinhado naturalmente permite que o computador acesse qualquer tipo de dados compatível com esse endereço sem gerar uma falha de alinhamento. O fator de alinhamento natural normalmente é o mesmo fator de alinhamento usado pelo alocador de memória do sistema e geralmente tem 8 bytes.
Os identificadores de entrada vêm em dois tipos: curto e longo prazo. Os identificadores de entrada de curto prazo são mais rápidos de construir, mas sua exclusividade é garantida apenas durante a vida útil da sessão atual na estação de trabalho atual. Identificadores de entrada de longo prazo têm um tempo de vida mais prolongado. Os identificadores de entrada de curto prazo são usados principalmente para linhas em tabelas e entradas em caixas de diálogo, enquanto os identificadores de entrada de longo prazo são usados para muitos objetos, como mensagens, pastas e listas de distribuição.