Share via


MSMQMessage.IsLastInTransaction

 

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

(Introduced in MSMQ 2.0.) The IsLastInTransaction property of the MSMQMessage object indicates whether the message was the last message sent in its transaction.

This property is superseded by MSMQMessage.IsLastInTransaction2 in MSMQ 3.0.

Data type: Short
Run-time access: Read-only
Property IsLastInTransaction As Short  

Property Value

A Short set to one of the following values:

1

The message was the last message sent in the transaction.

0

The message was not the last message sent in the transaction.

Remarks

This property is available for MSMQ 2.0 and later. It is used by receiving applications to verify that a message was the last message sent in a single transaction to a single queue.

You can use IsLastInTransaction along with two other properties to verify transaction boundaries. These two properties are a property for checking the first message sent in a transaction and a property for retrieving the identifier of the transaction: MSMQMessage.IsFirstInTransaction and MSMQMessage.TransactionId.

If only one message is sent in a transaction, both IsLastInTransaction and MSMQMessage.IsFirstInTransaction are set.

In C++ COM applications, you must use a smart pointer to the IMSMQMessage2 or IMSMQMessage3 interface to expose the IsLastInTransaction property.

Equivalent API Function Property

With API function calls, the equivalent property is PROPID_M_LAST_IN_XACT.

For information on See
How transaction boundaries can be used Checking for Transaction Boundaries when Receiving Messages
Checking the first message in the transaction MSMQMessage.IsFirstInTransaction
Retrieving the identifier of the transaction MSMQMessage.TransactionId

Requirements

Windows NT/2000/XP: Included in Windows 2000 and later.

Windows 95/98/Me: Unsupported.

Header: Declared in Mqoai.h.

Library: Use Mqoa.lib

See Also

MSMQMessage
MSMQMessage.IsFirstInTransaction
MSMQMessage.TransactionId
PROPID_M_LAST_IN_XACT