2.2.2.3 User-Defined Context Property
The user-defined context property, if present, MUST be included as part of both the client and prototype contexts during activation requests. This context property contains a logical set of name/value pairs.
The policyId field of the PROPMARSHALHEADER instance ([MS-DCOM] section 2.2.20.1) for the user-defined context property MUST be set to guidUserPropertiesProperty, as specified in section 1.9. The CLSID field of the PROPMARSHALHEADER instance ([MS-DCOM] section 2.2.20.1) for the activity context property MUST be set to GUID_NULL. The user-defined context property MUST be marshaled using the OBJREF_CUSTOM format ([MS-DCOM] section 2.2.18.6), and the CLSID field of the OBJREF_CUSTOM instance MUST be set to CLSID_UserContextProperty, as specified in section 1.9.
The format of the OBJREF_CUSTOM.pObjectData buffer for CLSID_UserContextProperty MUST be specified as follows:
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
MaxVersion |
MinVersion |
||||||||||||||||||||||||||||||
|
PropCount |
Properties (variable) |
||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
MaxVersion (2 bytes): The major version number for this UserProperty (section 2.2.2.3.1) format. This field MUST be set to 0x0001.
MinVersion (2 bytes): The minor version number for this UserProperty format. This field MUST be set to 0x0001.
PropCount (2 bytes): An unsigned short that MUST specify the number of elements in the Properties array.
Properties (variable): An array of UserProperty structures.