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 This object 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 This object 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 This object 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 This object 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 This object corresponds to a message in the queue. Each MSMQQueue object (described earlier) has an implicit collection of MSMQMessage objects.
  
  
• MSMQEvent This object 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 This object 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 This object provides a single method for creating a transaction object for internal transactions.

  For an example see:

  Sending Messages Using an Internal Transaction

• MSMQTransaction This object 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 This object provides a single method for obtaining the machine identifier of a computer.

© 1997 by Microsoft Corporation. All rights reserved.