2.3.7.6 URLMoniker

Referenced by: HyperlinkMoniker

This structure specifies a URL moniker. For more information about URL monikers, see [MSDN-URLM].


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

length

url (variable)

...

serialGUID (16 bytes, optional)

...

...

serialVersion (optional)

uriFlags (optional)

length (4 bytes): An unsigned integer that specifies the size of this structure in bytes, excluding the size of the length field.

The value of this field MUST be either the byte size of the url field (including the terminating NULL character) or the byte size of the url field plus 24.

If the value of this field is set to the byte size of the url field, then the serialGUID, serialVersion, and uriFlags fields MUST NOT be present.

If the value of this field is set to the byte size of the url field plus 24, then the serialGUID, serialVersion, and uriFlags fields MUST be present.

url (variable): A null-terminated array of Unicode characters that specifies the URL. The number of characters in the array is determined by the position of the terminating NULL character.

serialGUID (16 bytes): An optional GUID as specified by [MS-DTYP] for this implementation of the URL moniker serialization. This field MUST equal {0xF4815879, 0x1D3B, 0x487F, 0xAF, 0x2C, 0x82, 0x5D, 0xC4, 0x85, 0x27, 0x63} if present.

serialVersion (4 bytes): An optional unsigned integer that specifies the version number of this implementation of the URL moniker serialization. This field MUST equal 0 if present.

uriFlags (4 bytes): An optional URICreateFlags structure (section 2.3.7.7) that specifies creation flags for an [RFC3986] compliant URI.