The MSMQ Object Model

The MSMQ object model supports queue lookup, queue management, message management, and queue administration, allowing for a wide variety of MSMQ application development.

This object model includes:

• MSMQQuery locates a collection of queues. It provides a lookup method based on the queue's properties. The lookup method used by MSMQQuery returns an MSMQQueueInfos object that references the selected queues.

  For an example, see:

  Locating a Public Queue.

• MSMQQueueInfos represents a collection of MSMQQueueInfo objects, each corresponding to one of the queues found by the MSMQQuery object. It provides the methods for selecting one of the queues found in the query.

  For an example, see:

  Locating a Public Queue.

• MSMQQueueInfo contains the information needed to create or access a single queue. It provides methods for creating, opening, and deleting queues. Each time a queue is opened, an MSMQQueue object is returned.

  For examples see:

  Creating a Queue

  Opening a Queue

• MSMQQueue references a single instance of a queue. It provides methods for working with the messages in the queue as well as enabling receive notification and closing the queue instance.
• MSMQMessage corresponds to a message in the queue. Each MSMQQueue object (described earlier) has an implicit collection of MSMQMessage objects.
• MSMQEvent provides the events needed to implement a single event handler that can support multiple queues. Only two events are provided: message arrival and error notification.
• MSMQCoordinatedTransactionDispenser provides a single method for creating a transaction object for external transactions.

  For an example, see:

  Sending Messages Using an MS DTC External Transaction

• MSMQTransactionDispenser provides a single method for creating a transaction object for internal transactions.

  For an example, see:

  Sending Messages Using an Internal Transaction

• MSMQTransaction provides methods for committing and aborting transactions.

  For examples, see:

  Sending Messages Using an MS DTC External Transaction

  Sending Messages Using an Internal Transaction

• MSMQApplication provides a single method for obtaining the machine identifier of a computer.