Condividi tramite


PROPID_MGMT_QUEUE_EOD_NO_ACK_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

(Read-only, introduced in MSMQ 3.0.) The PROPID_MGMT_QUEUE_EOD_NO_ACK_COUNT property returns the number of messages sent from the computer to the queue for which no order acknowledgment has been received.

Property ID

PROPID_MGMT_QUEUE_EOD_NO_ACK_COUNT

Type Indicator

VT_UI4

MQPROPVARIANT Field

ulVal

Property Value

This property can return the following values:

  • Number of messages.

  • A 0 is returned if the applicable outgoing queue does not contain the requested information.

  • VT_NULL is returned if the queue is a local queue on the computer.

Remarks

To retrieve the number of messages sent from the computer to the queue for which no order acknowledgment has been received, include PROPID_MGMT_QUEUE_EOD_NO_ACK_COUNT in an MQMGMTPROPS structure, call MQMgmtGetInfo, and then examine the value returned.

This property can be retrieved only for an active queue. MQMgmtGetInfo will return a non-specific error (MQ_ERROR) if your application attempts to retrieve this information for a queue that does not contain messages and is not opened by an application.

Equivalent COM Property

When using COM components, you can retrieve the number of messages sent from a computer to a queue for which no order acknowledgment has been received by examining the EodNoAckCount element of the MSMQCollection object returned by the MSMQOutgoingQueueManagement.EodGetSendInfo method.

Example Code

The following code fragment shows how PROPID_MGMT_QUEUE_EOD_NO_ACK_COUNT is specified in arrays that can be used to initialize an MQMGMTPROPS structure.

aMgmtPropId[i] = PROPID_MGMT_QUEUE_EOD_NO_ACK_COUNT;    // Property ID  
aMgmtPropVar[i].vt = VT_NULL;                           // Type indicator  
i++;  

See Also

Management Properties
EodLastAck
MQMgmtGetInfo
MQMGMTPROPS