PROPID_MGMT_QUEUE_EOD_LAST_ACK_TIME

  • Article

 

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_LAST_ACK_TIME property returns the date and time when the last order acknowledgment for a message sent from the computer to the queue was received.

Property ID

PROPID_MGMT_QUEUE_EOD_LAST_ACK_TIME

Type Indicator

VT_UI4

MQPROPVARIANT Field

ulVal

Property Value

The time when the last order acknowledgment was received (VT_NULL is returned if the queue is a local queue on the computer). The time returned is the number of seconds elapsed since midnight (00:00:00), January 1, 1970 (Coordinated Universal Time) according to the system clock.

There are several related C run-time functions that can be used to manipulate the value returned by this property. For example, ctime() can be used to display the local date and time when the queue was created.

Remarks

To retrieve the date and time when the last order acknowledgment for a message sent from the computer to the queue was received, include PROPID_MGMT_QUEUE_EOD_LAST_ACK_TIME 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 time when the last order acknowledgment was received by examining the EodLastAckTime element of the MSMQCollection object returned by the MSMQOutgoingQueueManagement.EodGetSendInfo method.

Example Code

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

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

See Also

Management Properties
EodLastAckTime
MQMgmtGetInfo
MQMGMTPROPS