Delen via


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.

See Also

Management Properties
MQMgmtGetInfo
Subqueues