Marcas de propriedade MAPI

Aplica-se a: Outlook 2013 | Outlook 2016

Uma marca de propriedade é um número de 32 bits que contém um identificador de propriedade exclusivo nos bits 16 a 31 e um tipo de propriedade nos bits 0 a 15, conforme mostrado na ilustração a seguir.

Property tag elements

Elementos da marca de propriedade

As marcas de propriedade são usadas para identificar propriedades MAPI e todas as propriedades devem ter uma, independentemente de a propriedade ser definida por MAPI, um cliente ou um provedor de serviços. O MAPI define um conjunto de constantes de marca de propriedade para suas propriedades no arquivo de cabeçalho Mapitags.h; essas propriedades são chamadas de "propriedades definidas MAPI".

As constantes da marca de propriedade seguem uma convenção de nomenclatura para consistência e facilidade de uso. O nome de cada marca de propriedade tem duas partes: um prefixo PR_ e uma ou mais cadeias de caracteres que descrevem o conteúdo da propriedade. Várias cadeias de caracteres são separadas por sublinhados. Por exemplo, a marca de propriedade para o tipo de endereço de um destinatário de mensagem é PR_ADDRTYPE (PidTagOrgAddrtype) e o identificador de entrada para a pasta designada para receber uma cópia de cada mensagem de saída é PR_IPM_SENTMAIL_ENTRYID (PidTagIpmSentMailEntryId).

Algumas macros estão disponíveis para ajudar a trabalhar com tags de propriedade, entre elas PROP_TYPE, PROP_ID e PROP_TAG. PROP_TYPE extrai o tipo de propriedade da tag de propriedade; PROP_ID extrai o identificador. PROP_TAG cria uma marca de propriedade com base em um tipo de propriedade e identificador.

Confira também