Типы свойств
Область применения: Outlook 2013 | Outlook 2016
MAPI поддерживает свойства с одним и несколькими значениями. Свойство с одним значением имеет одно значение базового типа для свойства. Свойство с несколькими значениями имеет несколько значений базового типа.
Типы свойств с одним и несколькими значениями, поддерживаемые MAPI, описаны в следующей таблице. Для каждого типа с одним значением, имеющего соответствующий тип с несколькими значениями, тип с несколькими значениями отображается в скобках после типа с одним значением.
| Тип свойства | Шестнадцатеричное значение | Описание |
|---|---|---|
| PT_UNSPECIFIED |
0000 |
Указывает, что тип свойства неизвестен. Этот тип свойства зарезервирован для использования с методами интерфейса. |
| PT_NULL |
0001 |
Указывает отсутствие значения свойства. Этот тип свойства зарезервирован для использования с методами интерфейса и совпадает с типом OLE VT_NULL. |
| PT_I2 (PT_MV_I2) |
0002 |
Со знаком 16-разрядное (2-байтовое) целое число. Этот тип свойства совпадает с типом PT_SHORT (PT_MV_SHORT) и типом OLE VT_I2. |
| PT_I4 (PT_MV_I4) |
0003 |
Со знаком 32-разрядное (4-байтовое) целое число. Этот тип свойства совпадает с типом PT_LONG (PT_MV_LONG), а тип OLE VT_I4. |
| PT_FLOAT (PT_MV_FLOAT) |
0004 |
32-битовое (8-байтовое) значение с плавающей запятой. Этот тип свойства совпадает с типом PT_R4 (PT_MV_R4), а тип OLE VT_R4. |
| PT_DOUBLE (PT_MV_DOUBLE) |
0005 |
64-битовое (8-байтовое) значение с плавающей запятой. Этот тип свойства совпадает с типом PT_R8, а типы OLE VT_R8 и VT_DOUBLE. |
| PT_CURRENCY (PT_MV_CURRENCY ) |
0006 |
64-битовое (8-байтовое) целое число интерпретируется как десятичное. Этот тип свойства совместим с типом Microsoft Visual Basic CURRENCY и совпадает с типом OLE VT_CY. |
| PT_APPTIME (PT_MV_APPTIME) |
0007 |
Двойное значение, интерпретируемое как дата и время. Целочисленная часть — это дата, а часть дроби — время. Этот тип свойства совпадает с типом OLE VT_DATE и совместим с представлением времени Microsoft Visual Basic. |
| PT_ERROR |
000A |
Значение SCODE; 32-разрядное (4-байтовое) целое число без знака. Этот тип свойства совпадает с типом OLE VT_ERROR. |
| PT_BOOLEAN (PT_MV_12) |
000B |
16-битовое (2-байтовое) логическое значение, где ноль равно false , а ненулевой — true. Этот тип свойства совпадает с типом OLE VT_BOOL. |
| PT_OBJECT |
000D |
Указатель на объект, реализующий интерфейс IUnknown . Этот тип свойства похож на несколько типов OLE, например VT_UNKNOWN. |
| PT_I8 (PT_MV_I8) |
0014 |
Со знаком 64-разрядное (8-байтовое) целое число, использующее структуру LARGE_INTEGER . Этот тип свойства совпадает с типом PT_I8, а тип OLE VT_I8. |
| PT_STRING8 (PT_MV_STRING8) |
001E |
8-битовая (2-байтовая) символьная строка с пустым завершением. Этот тип свойства совпадает с типом OLE VT_LPSTR. |
| PT_TSTRING (PT_MV_TSTRING) |
001F |
16-битовая (2-байтовая) символьная строка с пустым завершением. Свойства с этим типом сбрасываются на PT_UNICODE при компиляции с символом ЮНИКОД и для PT_STRING8 при компиляции с символом ЮНИКОД. Этот тип свойства совпадает с типом OLE VT_LPSTR для результирующего свойства PT_STRING8 и VT_LPWSTR для свойств PT_UNICODE |
| PT_SYSTIME (PT_MV_SYSTIME) |
0040 |
64-разрядные (8-байтовые) целочисленные данные и значение времени в виде структуры FILETIME . Этот тип свойства совпадает с типом OLE VT_FILETIME. |
| PT_CLSID (PT_MV_CLSID) |
0048 |
Значение структуры CLSID. Этот тип свойства совпадает с типом OLE VT_CLSID. |
| PT_SVREID |
00FB |
Переменный размер, 16-битовое (2-байтовое) ЧИСЛО , за которым следует структура. |
| PT_SRESTRICT |
00FD |
Переменный размер — массив байтов, представляющий одну или несколько структур ограничений. |
| PT_ACTIONS |
00FE |
Переменный размер, 16-битовое (2-байтовое) ЧИСЛО действий (не байтов), за которым следует множество структур действия правила. |
| PT_BINARY (PT_MV_BINARY) |
0102 |
Значение структуры SBinary — подсчитываемый массив байтов. |
Примечание.
Чтобы определить шестнадцатеричное значение для многозначного типа свойства, ИЛИ PT_MV флаг (0x00001000) с шестнадцатеричным значением для типа свойства. Например, шестнадцатеричное значение для PT_MV_UNICODE равно 0x101F, а шестнадцатеричное значение для PT_MV_BINARY — 0x1102.
MAPI использует номера типов значений с [вариантами OLE]. Однако для MAPI указываются не все типы OLE. В частности, неподписанные типы, такие как VT_UI4 не имеют аналогов в MAPI. Сравнение значений свойств PT_I2/I4/I8, например при оценке [ограничений] (фильтров), выполняется как подписанное сравнение.