PROPID_M_MOVE_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.) The PROPID_M_MOVE_COUNT property indicates the number of times that transactional processing has been aborted on a message during its lifetime.

Property ID

PROPID_M_MOVE_COUNT

Type Indicator

VT_UI4

Property Value

A count of the number of times that transactional processing has been aborted on a message during its lifetime.

Remarks

The PROPID_M_MOVE_COUNT property of a message is incremented by the Message Queuing service (MSMQ) each time the transaction that is used to receive the message from the queue is aborted. For this reason, the PROPID_M_MOVE_COUNT property is valid only for messages that are received within a transaction from a transactional queue. If the message is not received within a transaction or the queue is not transactional, the PROPID_M_MOVE_COUNT property is not incremented. The default value for this property is 0.

A message's PROPID_M_MOVE_COUNT property is never reset. However, if a message is moved to or from a subqueue, its PROPID_M_ABORT_COUNT property is reset to 0. This lets your application divide message retrieval attempts into cycles, with a certain abort count allowed for each cycle, without losing track of the total abort count.

Requirements

Windows NT/2000/XP/Vista: Requires Windows Vista or later.

Windows 95/98/Me: Not supported.

Header: Declared in Mqoai.h.

Library: Use Mqoa.lib.

See Also

PROPID_M_ABORT_COUNT
Subqueues
Message Properties