Share via

MSMQMessage.IsFirstInTransaction

  • 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

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

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

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

Property Value

A Short set to one of the following values:

1

The message was the first message sent in the transaction.

0

The message was not the first 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 first message sent in a single transaction to a single queue.

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

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

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

Equivalent API Function Property

With API function calls, the equivalent property is PROPID_M_FIRST_IN_XACT.

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

Requirements

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

Windows 95/98/Me: Included in Windows 95 and later.

Header: Declared in Mqoai.h.

Library: Use Mqoa.lib

See Also

MSMQMessage
MSMQMessage.IsLastInTransaction
MSMQMessage.TransactionId
PROPID_M_FIRST_IN_XACT