Share via


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.

See Also

Management Properties
MQMgmtGetInfo
Subqueues