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
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. O MAPI define muitas propriedades, algumas para descrever muitos objetos e algumas que são apropriadas apenas para um objeto de um tipo específico. Clientes e provedores de serviços podem estender o conjunto de propriedades predefinidas do MAPI criando propriedades novas e personalizadas. Os clientes podem definir propriedades para descrever novas classes de mensagens 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 para 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 folhas de propriedades são caixas de diálogo com guias que exibem as propriedades relacionadas para um único objeto. As folhas de propriedades podem fornecer acesso somente leitura ou leitura/gravação aos dados. Se um usuário tem ou não permissão para fazer alterações cabe ao implementador da folha de propriedades.
A interface IMAPIProp é a interface principal 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.
Existem várias estruturas de dados para descrever propriedades e informações sobre propriedades. As estruturas mais comumente 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 booleano.
Valor numérico dentro de um intervalo específico que identifica exclusivamente a propriedade e o componente responsáveis por mantê-lo. Por exemplo, há um intervalo para manter as propriedades de conteúdo da mensagem definidas por 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. As tags de propriedade são constantes que podem ser usadas para se referir facilmente à propriedade. As marcas de propriedade para propriedades definidas por MAPI estão incluídas nos MAPITAGS. H e no membro ulPropTag de uma estrutura SPropValue . Clientes e provedores de serviços usam tags de propriedade para identificar, recuperar e atualizar as propriedades correspondentes.
A estrutura SPropTagArray é uma matriz contada de marcas de propriedade. Muitos dos métodos em IMAPIProp e outras interfaces usam uma estrutura SPropTagArray para descrever propriedades.