CMListener

Class

Superclasses

System.Object
  Listener
    CMListener

Visual Basic

Public Class CMListener
  Inherits Listener

C#

public class CMListener : Listener

Purpose

A certified delivery listener object listens for labeled messages and certified messages.

Remarks

Each call to the constructor CMListener results in a new certified delivery listener, which represents your program’s listening interest in a stream of labeled messages and certified messages. Rendezvous software uses the same listener object to signal each occurrence of such an event.

We recommend that programs explicitly destroy each certified delivery listener object using CMListener.Destroy. Destroying a certified listener object cancels the program’s immediate interest in that event, and frees its storage; nonetheless, a parameter to the destroy call determines whether certified delivery agreements continue to persist beyond the destroy call.

Programs must destroy instances of this class. Rendezvous software keeps internal references to these objects, so the garbage collector does not delete them automatically.

Destroying the queue or the certified delivery transport of a listener object automatically destroys the listener as well (but certified delivery agreements continue to persist).

Member	Description
Public Instance Properties
Queue	Queue The listener’s event queue. (Inherited from Listener.)	Get
Subject	string The listener expresses interest in this subject, and receives messages with matching destination subjects. (Inherited from Listener.)	Get
Transport	Transport The listener receives inbound messages from this transport. (Inherited from Listener.)	Get

Method	Description	Page
CMListener	Listen for messages that match the subject, and request certified delivery when available.	CMListener
CMListener.ConfirmMessage	Explicitly confirm delivery of a certified message.	CMListener.ConfirmMessage
CMListener.Destroy	Destroy a certified delivery listener.	CMListener.Destroy
CMListener.SetExplicitConfirmation	Override automatic confirmation of delivery for this listener.	CMListener.SetExplicitConfirmation

Related Classes

Listener

MessageReceivedEventHandler

Top