PROPID_MGMT_QUEUE_SUBQUEUE_COUNT
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_COUNT property can be used to retrieve the count of the number of subqueues in a specified queue.
Property ID
PROPID_MGMT_QUEUE_SUBQUEUE_COUNT
Type Indicator
VT_UI4
MQPROPVARIANT Field
calpwstr
Property Value
A count of the number of subqueues for a specified queue.
Remarks
To retrieve a count of the number of subqueues, include PROPID_MGMT_QUEUE_SUBQUEUE_COUNT in the MQMGMTPROPS structure, and then call MQMgmtGetInfo.
When specifying PROPID_MGMT_QUEUE_SUBQUEUE_COUNT in the MQMGMTPROPS structure, set its type indicator to VT_NULL. During the function call, Message Queuing automatically changes the type indicator to VT_UI4 and creates the buffers needed to receive the property values. The number of subqueues found 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_COUNT is used to initialize an MQMGMTPROPS structure for retrieving a count of the number of subqueues.
aMgmtPropID[cPropId] = PROPID_MGMT_QUEUE_SUBQUEUE_COUNT; // 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.