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 que o MAPI dá suporte são descritos na tabela a seguir. Para cada tipo de valor único que tem um tipo de múltiplo valor correspondente, o tipo de valor múltiplo aparece em 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 nenhum 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 assinado de 16 bits (2 bytes). Esse tipo de propriedade é o mesmo que PT_SHORT (PT_MV_SHORT) e o tipo OLE VT_I2. |
| PT_I4 (PT_MV_I4) |
0003 |
Inteiro assinado de 32 bits (4 bytes). Esse tipo de propriedade é o mesmo que 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 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 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. Esse tipo de propriedade é compatível com o tipo CURRENCY do Microsoft Visual Basic 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 inteiro é 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 sem sinal de 32 bits (4 bytes). Esse tipo de propriedade é o mesmo que o tipo OLE VT_ERROR. |
| PT_BOOLEAN (PT_MV_12) |
000B |
Valor booliano de 16 bits (2 bytes) em que zero é igual a false e não zero é igual a true. 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 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 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) com término nulo. 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 ao 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 da variável, um COUNT de 2 bits (2 bytes) seguido de uma estrutura. |
| PT_SRESTRICT |
00FD |
Tamanho da variável, uma matriz de bytes que representa uma ou mais estruturas de restrição. |
| PT_ACTIONS |
00FE |
Tamanho da variável, uma contagem de ações de 2 bytes (2 bytes) de 16 bits seguida por tantas estruturas de Ação de Regra. |
| PT_BINARY (PT_MV_BINARY) |
0102 |
Valor da estrutura SBinary , uma matriz de bytes contada. |
Observação
Para determinar o valor Hex para o tipo de propriedade com vários valores, OR o sinalizador de 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), é executada como uma comparação assinada.