MSMQManagement.TransactionalStatus
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 3.0). The TransactionalStatus property of the MSMQManagement object, which represents the elements of the state of a queue that are common to destination and outgoing queues, returns a flag that indicates whether a destination queue is or is not a transactional queue or whether an outgoing queue is associated with a transactional queue or with a nontransactional destination queue.
| Data type: | Long |
| Run-time access: | Read-only |
Property TransactionalStatus As Long
Property Value
The TransactionalStatus property can have any one of the following values:
MQ_XACT_STATUS_XACT
For destination queues, the queue is a transactional queue.
For outgoing queues, the queue is associated with a transactional queue.
MQ_XACT_STATUS_NOT_XACT
For destination queues, the queue is a nontransactional queue.
For outgoing queues, the queue is associated with a nontransactional queue.
MQ_XACT_STATUS_UNKNOWN
Message Queuing was not able to determine whether or not the queue is a transactional queue.
For outgoing queues, this flag is returned if the queue is a remote private queue, or if the queue is a remote public queue and the remote queue manager is offline.
Remarks
The MSMQManagement object can be initialized to refer to an active destination or outgoing queue, depending on the parameters passed to the MSMQManagement.Init method when the object is initialized. If the MSMQManagement object represents the state of an outgoing queue, the TransactionalStatus property indicates whether the destination queue associated with it is transactional.
Equivalent API Function Property
When using API functions, the equivalent property is PROPID_MGMT_QUEUE_XACT.
Requirements
Windows NT/2000/XP: Included in Windows XP and Windows Server 2003.
Windows 95/98/Me: Unsupported.
Header: Declared in Mqoai.h.
Library: Use Mqoa.lib