3.2.4.6 Retrieving Local Private Queue Properties

The MSMQ application MUST supply a format name for a local private queue from which to retrieve property values and a set of property identifiers for which values are to be retrieved. Additionally, the client MUST provide a set of PROPVARIANTs into which the server will place the requested property values. MSMQ queue property values and the PROPVARIANT structure are defined in [MS-MQMQ] section 2.2.13.2.

  • The given format name MUST be of the "private" or "direct" variety, as specified in [MS-MQMQ] section 2.1.

  • The client MUST call R_QMGetObjectProperties, supplying the following parameter values:

    • A pointer to an OBJECT_FORMAT structure containing the format name of the queue, as specified in section 3.1.4.9.

    • cp MUST contain the number of properties to be retrieved.

    • aProp MUST contain an array of queue property identifiers requested by the MSMQ application. The array MUST contain cp elements. The property identifiers in aProp MUST be in the table in section 3.1.1.12 and MUST be marked as applicable for a Get operation.

    • apVar MUST contain an array of  PROPVARIANT structures to be populated by the server. The array MUST contain cp elements.