Tipos de propriedade

Aplica-se a: Outlook 2013 | Outlook 2016

O MAPI dá suporte a propriedades de valor único e de vários valores. Com uma propriedade de valor único, há um valor do tipo base para a propriedade. Com uma propriedade de vários valores, há vários valores do tipo base.

Os tipos de propriedade de valor único e de vários valores com suporte MAPI são descritos na tabela a seguir. Para cada tipo de valor único que tenha um tipo de vários valores correspondente, o tipo de vários valores aparece entre parênteses após o tipo de valor único.

Tipo de Propriedade Valor hexadecimal Descrição
PT_UNSPECIFIED
0000
Indica que o tipo de propriedade é desconhecido. Esse tipo de propriedade é reservado para uso com métodos de interface.
PT_NULL
0001
Indica que não há valor de propriedade. Esse tipo de propriedade é reservado para uso com métodos de interface e é o mesmo que o tipo OLE VT_NULL.
PT_I2 (PT_MV_I2)
0002
Inteiro de 16 bits (2 bytes) assinado. Esse tipo de propriedade é o mesmo que o PT_SHORT (PT_MV_SHORT) e o tipo OLE VT_I2.
PT_I4 (PT_MV_I4)
0003
Inteiro de 32 bits (4 bytes) assinado. Esse tipo de propriedade é o mesmo que o PT_LONG (PT_MV_LONG) e o tipo OLE VT_I4.
PT_FLOAT (PT_MV_FLOAT)
0004
Valor de ponto flutuante de 32 bits (8 bytes). Esse tipo de propriedade é o mesmo que o PT_R4 (PT_MV_R4) e o tipo OLE VT_R4.
PT_DOUBLE (PT_MV_DOUBLE)
0005
Valor de ponto flutuante de 64 bits (8 bytes). Esse tipo de propriedade é o mesmo que o PT_R8 e os tipos OLE VT_R8 e VT_DOUBLE.
PT_CURRENCY (PT_MV_CURRENCY)
0006
Inteiro de 64 bits (8 bytes) interpretado como decimal. Este tipo de propriedade é compatível com o tipo Microsoft Visual Basic CURRENCY e é o mesmo que o tipo OLE VT_CY.
PT_APPTIME (PT_MV_APPTIME)
0007
Valor duplo que é interpretado como data e hora. A parte inteira é a data e a parte da fração é a hora. Esse tipo de propriedade é o mesmo que o tipo OLE VT_DATE e é compatível com a representação de tempo do Microsoft Visual Basic.
PT_ERROR
000A
valor SCODE; Inteiro não assinado de 32 bits (4 bytes). Esse tipo de propriedade é o mesmo que o tipo OLE VT_ERROR.
PT_BOOLEAN (PT_MV_12)
000B
Valor booleano de 16 bits (2 bytes) em que zero é igual a falso e diferente de zero é igual a verdadeiro. Esse tipo de propriedade é o mesmo que o tipo OLE VT_BOOL.
PT_OBJECT
000D
Ponteiro para um objeto que implementa a interface IUnknown . Esse tipo de propriedade é semelhante a vários tipos de OLE, como VT_UNKNOWN.
PT_I8 (PT_MV_I8)
0014
Inteiro de 64 bits (8 bytes) assinado que usa a estrutura LARGE_INTEGER . Esse tipo de propriedade é o mesmo que o PT_I8 e o tipo OLE VT_I8.
PT_STRING8 (PT_MV_STRING8)
001E
Cadeia de caracteres de 8 bits (2 bytes) terminada em nulo. Esse tipo de propriedade é o mesmo que o tipo OLE VT_LPSTR.
PT_TSTRING (PT_MV_TSTRING)
001F
Cadeia de caracteres de 16 bits (2 bytes) terminada em nulo. As propriedades com esse tipo têm o tipo de propriedade redefinido para PT_UNICODE ao compilar com o símbolo UNICODE e para PT_STRING8 quando não compilar com o símbolo UNICODE. Esse tipo de propriedade é o mesmo que o tipo OLE VT_LPSTR para propriedades PT_STRING8 resultantes e VT_LPWSTR para propriedades PT_UNICODE
PT_SYSTIME (PT_MV_SYSTIME)
0040
Dados inteiros de 64 bits (8 bytes) e valor de tempo na forma de uma estrutura FILETIME . Esse tipo de propriedade é o mesmo que o tipo OLE VT_FILETIME.
PT_CLSID (PT_MV_CLSID)
0048
Valor da estrutura CLSID. Esse tipo de propriedade é o mesmo que o tipo OLE VT_CLSID.
PT_SVREID
00FB
Tamanho variável, uma CONTAGEM de 16 bits (2 bytes) seguida por uma estrutura.
PT_SRESTRICT
00FD
Tamanho variável, uma matriz de bytes que representa uma ou mais estruturas de restrição.
PT_ACTIONS
00FE
Tamanho variável, uma CONTAGEM de 16 bits (2 bytes) de ações (não bytes) seguida por tantas estruturas de ação de regra.
PT_BINARY (PT_MV_BINARY)
0102
SBinary , uma matriz de bytes contados.

Observação

Para determinar o valor Hex para o tipo de propriedade de valores múltiplos, OU o sinalizador PT_MV (0x00001000) para o valor Hex para o tipo de propriedade. Por exemplo, o valor Hex para PT_MV_UNICODE é 0x101F e o valor Hex para PT_MV_BINARY é 0x1102.

O MAPI compartilha os números de tipo de valor com [variantes OLE]. No entanto, nem todos os tipos OLE são especificados para MAPI. Em particular, tipos não assinados, como VT_UI4, não têm contrapartida no MAPI. A comparação dos valores de propriedade PT_I2/I4/I8, por exemplo, durante a avaliação de [restrições] (filtros), é realizada como uma comparação assinada.

  • Last updated on