Identificadores de entrada MAPI
Aplica-se a: Outlook 2013 | Outlook 2016
Os identificadores de entrada são partes de dados binários armazenados em uma estrutura ENTRYID que são usadas 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 transmitíveis e não podem ser usados em sistemas diferentes do sistema em que se originaram.
Identificadores de Entrada
Os provedores do repositório de mensagens atribuem identificadores de entrada a armazenamentos 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 status na tabela status. Os objetos armazenam seus identificadores de entrada na 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 binários comparáveis, 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 devem lidar com identificadores de entrada que estão arbitrariamente alinhados, 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 é de 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 serem construídos, mas sua exclusividade é garantida apenas ao longo da vida útil da sessão atual na estação de trabalho atual. Os identificadores de entrada de longo prazo têm uma vida útil mais prolongada. 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.