PROPID_MGMT_QUEUE_SUBQUEUE_NAMES
Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista
The PROPID_MGMT_QUEUE_SUBQUEUE_NAMES property can be used to retrieve the names of the subqueues in a specified queue.
Property ID
PROPID_MGMT_QUEUE_SUBQUEUE_NAMES
Type Indicator
VT_LPWSTR
MQPROPVARIANT Field
calpwstr
Property Value
An array of elements that contains the names of the subqueues.
Remarks
To retrieve a list of subqueues for a given queue, include PROPID_MGMT_QUEUE_SUBQUEUE_NAMES in the MQMGMTPROPS structure, and then call MQMgmtGetInfo.
When specifying PROPID_MGMT_QUEUE_SUBQUEUE_NAMES in the MQMGMTPROPS structure, set its type indicator to VT_NULL. During the function call, Message Queuing automatically changes the type indicator to VT_LPWSTR and creates the buffers needed to receive the property values. The number of subqueues is returned in the cElems member of the calpwstr field of the applicable MQPROPVARIANT element in the property values array.
Example Code
The following code fragment shows how PROPID_MGMT_QUEUE_SUBQUEUE_NAMES is used to initialize an MQMGMTPROPS structure for retrieving a count of the number of subqueues.
aMgmtPropID[cPropId] = PROPID_MGMT_QUEUE_SUBQUEUE_NAMES; // property identifier
aMgmtPropVar[cPropId].vt = VT_NULL; // type indicator
cPropId++;
Requirements
Windows NT/2000/XP: Requires Windows Vista or later.
Windows 95/98/Me: Not supported.
Header: Declared in Mqoai.h.
Library: Use Mqoa.lib.