Visão geral da propriedade MAPI
Aplica-se a: Outlook 2013 | Outlook 2016
Uma propriedade é um atributo de um objeto MAPI. As propriedades descrevem algo sobre o objeto, como a linha de assunto de uma mensagem ou o tipo de endereço de um usuário de mensagens. MAPI define muitas propriedades, algumas para descrever muitos objetos e alguns que são apropriados apenas para um objeto de determinado tipo. Clientes e provedores de serviços podem estender o conjunto de propriedades predefinidas da MAPI criando novas propriedades personalizadas. Os clientes podem definir propriedades para descrever novas classes de mensagem, e os provedores de serviços podem definir propriedades para expor os recursos exclusivos de seu sistema de mensagens.
As propriedades podem ser persistentes ou temporárias. As propriedades que persistem de sessão em sessão podem ser armazenadas com os dados de seus objetos ou no perfil. As propriedades temporárias existem apenas durante a sessão atual.
Clientes e provedores de serviços podem mostrar propriedades aos usuários com uma tabela ou uma folha de propriedades. As tabelas fornecem aos usuários uma exibição somente leitura de algumas das propriedades pertencentes a vários objetos. Os dados são exibidos no formato de linha e coluna, com cada linha representando um objeto e cada coluna uma propriedade. As planilhas de propriedades são caixas de diálogo com tabbed que exibem propriedades relacionadas para um único objeto. As planilhas de propriedades podem fornecer acesso somente leitura ou leitura/gravação aos dados. Se um usuário tem permissão ou não para fazer alterações, cabe ao implementador da folha de propriedades.
A interface IMAPIProp é a interface primária para trabalhar com propriedades. Todos os objetos que dão suporte a propriedades implementam IMAPIProp. O IMAPIProp inclui métodos para recuperar valores de propriedade, copiar propriedades, fazer alterações e salvar essas alterações, mapear entre nomes de propriedade e seus identificadores e recuperar informações sobre um erro anterior.
Há várias estruturas de dados para descrever propriedades e informações sobre propriedades. As estruturas mais usadas são a estrutura SPropValue e a estrutura SPropTagArray . A estrutura SPropValue contém as três informações que descrevem uma propriedade:
Dados ou valor da propriedade.
Tipo de dados do valor da propriedade, como inteiro ou booliano.
Valor numérico dentro de um intervalo específico que identifica exclusivamente a propriedade e o componente responsáveis pela manutenção. Por exemplo, há um intervalo para manter as propriedades de conteúdo da mensagem definidas pelo MAPI e outro intervalo para manter as propriedades de conteúdo da mensagem definidas por um cliente para uma classe de mensagem personalizada.
O tipo de propriedade e o identificador são combinados em um único componente chamado marca de propriedade. Marcas de propriedade são constantes que podem ser usadas para se referir facilmente à propriedade. As marcas de propriedade para propriedades definidas pelo MAPI estão incluídas no MAPITAGS. Arquivo de cabeçalho H e no membro ulPropTag de uma estrutura SPropValue . Clientes e provedores de serviços usam marcas de propriedade para identificar, recuperar e atualizar as propriedades correspondentes.
A estrutura SPropTagArray é uma matriz contada de marcas de propriedade. Muitos dos métodos no IMAPIProp e em outras interfaces usam uma estrutura SPropTagArray para descrever propriedades.