2.3.7.5 ItemMoniker

Referenced by: HyperlinkMoniker

This structure specifies an item moniker. Item monikers are used to identify objects within containers, such as a portion of a document, an embedded object within a compound document, or a range of cells within a spreadsheet. For more information about item monikers, see [MSDN-IMCOM].


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

delimiterLength

delimiterAnsi (variable)

...

delimiterUnicode (variable)

...

itemLength

itemAnsi (variable)

...

itemUnicode (variable)

...

delimiterLength (4 bytes): An unsigned integer that specifies the sum of the count of bytes in the delimiterAnsi and delimiterUnicode fields.

delimiterAnsi (variable): A null-terminated array of ANSI characters that specifies a delimiter for this moniker. Delimiters are used to separate monikers that are part of a collection of monikers in a composite moniker. The number of characters in the array is determined by the position of the terminating NULL character.

delimiterUnicode (variable): An optional array of Unicode characters that specifies a delimiter for this moniker if the delimiter cannot be completely specified in ANSI characters. This field MUST exist if and only if delimiterLength is greater than the size of delimiterAnsi in bytes. The number of characters in the array is determined by (delimiterLength - (size of delimiterAnsi in bytes)) / 2.

itemLength (4 bytes): An unsigned integer that specifies the count of bytes in the itemAnsi and itemUnicode fields.

itemAnsi (variable): A null-terminated array of ANSI characters that specifies the string used to identify this item in a collection of items. The number of characters in this array is specified by itemLength.

itemUnicode (variable): An optional array of Unicode characters that specifies the string used to identify this item in a collection of items, if the string cannot be completely specified in ANSI characters. This field MUST exist if and only if itemLength is greater than the size of itemAnsi in bytes. The number of characters in the array is determined by (itemLength – (size of itemAnsi field in bytes)) / 2.