Property Structures

MSMQ uses three property structures: MQQUEUEPROPS for queue properties, MQMSGPROPS for message properties, and MQQMPROPS for Queue Manager properties. All three structures have the following four members:

• A count (cProp) indicating how many properties are supplied. This is a double word member field (DWORD) included in all three property structures.
• An array of PROPID values (aPropID) identifying which properties are specified for the call. MSMQ uses three different property identifiers: QUEUEPROPID, MSGPROPID, and QMPROPID. These identifiers are used for MSMQ queue properties, message properties, and Queue Manager properties, respectively. These identifiers are all of type PROPID.
• An array of PROPVARIANT structures (aPropVar) containing the values of the properties. Position i in this array is the value of the property whose identifier (PROPID value) is in position i in its respective aPropID array.
• An array of HRESULT values (aStatus) returned by MSMQ. Position i in this array is a reported status code of the property whose identifier and value are in position i in the arrays discussed earlier. This array is optional.

For information on the specific property structures, see MQQUEUEPROPS, MQMSGPROPS, and MQQMPROPS.