2.6.1 PropertyName Structure


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

Kind

GUID

...

...

...

...

LID (optional)

...

NameSize (optional)

Name (optional) (variable)

...

Kind (1 byte): The possible values for the Kind field are in the following table.

Value

Meaning

0x00

The property is identified by the LID field.

0x01

The property is identified by the Name field.

0xFF

The property does not have an associated PropertyName field.

GUID (16 bytes): The GUID that identifies the property set for the named property.

Note The GUID field is treated as a FlatUID structure, as specified in section 2.5.1, and consequently is in little-endian byte order. Client code on big-endian systems is therefore required to place GUID fields in little-endian byte order in the request buffer.

LID (optional) (4 bytes): This field is present only if the value of the Kind field is equal to 0x00. An unsigned integer that identifies the named property within its property set.

NameSize (optional) (1 byte): The value of this field is equal to the number of bytes in the Name string that follows it. This field is present only if the value of the Kind field is equal to 0x01.

Name (optional) (variable): This field is present only if Kind is equal to 0x01. The value is a Unicode (UTF-16 format) string, followed by two zero bytes as terminating null characters, that identifies the property within its property set.