Partager via

2.11.1 Property Data Types

  • Article

For all variants, the structure of a property value is the same and is specified by the property data type, whether or not the property data type is actually encoded in the buffer. The following table lists both the property data type identifiers and the format of the property values. Web Distributed Authoring and Versioning Protocol (WebDAV) property data type identifiers are specified in section 2.11.1.6.

There is one variation in the width of count fields. In the context of ROP buffers, such as the RopGetPropertiesSpecific ROP ([MS-OXCROPS] section 2.2.8.3), byte counts for PtypBinary property values are 16 bits wide and value counts for all PtypMultiple property values are 32 bits wide. However, in the context of extended rules, as specified in [MS-OXORULE] section 2.2.4, and in the context of the MAPI extensions for HTTP, as specified in [MS-OXCMAPIHTTP] section 2.2.5, byte counts for PtypBinary property values and value counts for PtypMultiple property values are 32 bits wide. Such count fields have a width designation of COUNT, as specified in section 2.11.1.1, rather than an explicit width, as throughout section 2.11.

In the context of a table operation, properties are referred to as columns. The format of property identifiers, types, and values in table operations such as the RopQueryRows ROP ([MS-OXCROPS] section 2.2.5.4) is the same as in property operations such as the RopGetPropertiesSpecific ROP. Property data types are presented in the following table. The property data type values specified are 16-bit integers. The Name Service Provider Interface (NSPI) Protocol, as specified in [MS-NSPI], uses the same numeric values but expresses them as 32-bit integers, with the high-order 16 bits of the 32-bit representation set to 0x0000.

Property type name

Property type value

Property type specification

Alternate names

PtypInteger16

0x0002,

%x02.00

2 bytes; a 16-bit integer

[MS-DTYP]: INT16

PT_SHORT, PT_I2, i2, ui2

PtypInteger32

0x0003,

%x03.00

4 bytes; a 32-bit integer

[MS-DTYP]: INT32

PT_LONG, PT_I4, int, ui4

PtypFloating32

0x0004,

%x04.00

4 bytes; a 32-bit floating point number

[MS-DTYP]: FLOAT

PT_FLOAT, PT_R4, float, r4

PtypFloating64

0x0005,

%x05.00

8 bytes; a 64-bit floating point number

[MS-DTYP]: DOUBLE

PT_DOUBLE, PT_R8, r8

PtypCurrency

0x0006,

%x06.00

8 bytes; a 64-bit signed, scaled integer representation of a decimal currency value, with four places to the right of the decimal point

[MS-DTYP]: LONGLONG

[MS-OAUT]: CURRENCY

PT_CURRENCY, fixed.14.4

PtypFloatingTime

0x0007,

%x07.00

8 bytes; a 64-bit floating point number in which the whole number part represents the number of days since December 30, 1899, and the fractional part represents the fraction of a day since midnight

[MS-DTYP]: DOUBLE

[MS-OAUT]: DATE

PT_APPTIME

PtypErrorCode

0x000A,

%x0A.00

4 bytes; a 32-bit integer encoding error information as specified in section 2.4.1.

PT_ERROR

PtypBoolean

0x000B,

%x0B.00

1 byte; restricted to 1 or 0

[MS-DTYP]: BOOLEAN

PT_BOOLEAN. bool

PtypInteger64

0x0014,

%x14.00

8 bytes; a 64-bit integer

[MS-DTYP]: LONGLONG

PT_LONGLONG, PT_I8, i8, ui8

PtypString

0x001F,

%x1F.00

Variable size; a string of Unicode characters in UTF-16LE format encoding with terminating null character (0x0000).

PT_UNICODE, string

PtypString8

0x001E,

%z1E.00

Variable size; a string of multibyte characters in externally specified encoding with terminating null character (single 0 byte).

PT_STRING8

PtypTime

0x0040,

%x40.00

8 bytes; a 64-bit integer representing the number of 100-nanosecond intervals since January 1, 1601

[MS-DTYP]: FILETIME

PT_SYSTIME, time, datetime, datetime.tz, datetime.rfc1123, Date, time, time.tz

PtypGuid

0x0048,

%x48.00

16 bytes; a GUID with Data1, Data2, and Data3 fields in little-endian format

[MS-DTYP]: GUID

PT_CLSID, UUID

PtypServerId

0x00FB,

%xFB.00

Variable size; a 16-bit COUNT field followed by a structure as specified in section 2.11.1.4.

PT_SVREID

PtypRestriction

0x00FD,

%xFD.00

Variable size; a byte array representing one or more Restriction structures as specified in section 2.12.

PT_SRESTRICT

PtypRuleAction

0x00FE,

%xFE.00

Variable size; a 16-bit COUNT field followed by that many rule action structures, as specified in [MS-OXORULE] section 2.2.5.

PT_ACTIONS

PtypBinary

0x0102,

%x02.01

Variable size; a COUNT field followed by that many bytes.

PT_BINARY

PtypMultipleInteger16

0x1002,

%x02.10

Variable size; a COUNT field followed by that many PtypInteger16 values.

PT_MV_SHORT, PT_MV_I2, mv.i2

PtypMultipleInteger32

0x1003,

%x03.10

Variable size; a COUNT field followed by that many PtypInteger32 values.

PT_MV_LONG, PT_MV_I4, mv.i4

PtypMultipleFloating32

0x1004,

%x04.10

Variable size; a COUNT field followed by that many PtypFloating32 values.

PT_MV_FLOAT, PT_MV_R4, mv.float

PtypMultipleFloating64

0x1005,

%x05.10

Variable size; a COUNT field followed by that many PtypFloating64 values.

PT_MV_DOUBLE, PT_MV_R8

PtypMultipleCurrency

0x1006,

%x06.10

Variable size; a COUNT field followed by that many PtypCurrency values.

PT_MV_CURRENCY, mv.fixed.14.4

PtypMultipleFloatingTime

0x1007,

%x07.10

Variable size; a COUNT field followed by that many PtypFloatingTime values.

PT_MV_APPTIME

PtypMultipleInteger64

0x1014,

%x14.10

Variable size; a COUNT field followed by that many PtypInteger64 values.

PT_MV_I8, PT_MV_LONGLONG

PtypMultipleString

0x101F,

%x1F.10

Variable size; a COUNT field followed by that many PtypString values.

PT_MV_UNICODE

PtypMultipleString8

0x101E,

%x1E.10

Variable size; a COUNT field followed by that many PtypString8 values.

PT_MV_STRING8, mv.string

PtypMultipleTime

0x1040,

%x40.10

Variable size; a COUNT field followed by that many PtypTime values.

PT_MV_SYSTIME

PtypMultipleGuid

0x1048,

%x48.10

Variable size; a COUNT field followed by that many PtypGuid values.

PT_MV_CLSID, mv.uuid

PtypMultipleBinary

0x1102,

%x02.11

Variable size; a COUNT field followed by that many PtypBinary values.

PT_MV_BINARY, mv.bin.hex

PtypUnspecified

0x0000,

%x00.00

Any: this property type value matches any type; a server MUST return the actual type in its response. Servers MUST NOT return this type in response to a client request other than NspiGetIDsFromNames or the RopGetPropertyIdsFromNames ROP request ([MS-OXCROPS] section 2.2.8.1).

PT_UNSPECIFIED

PtypNull

0x0001,

%x01.00

None: This property is a placeholder.

PT_NULL

PtypObject or PtypEmbeddedTable

0x000D,

%x0D.00

The property value is a Component Object Model (COM) object, as specified in section 2.11.1.5.

PT_OBJECT