CMListener.Destroy

Method

Visual Basic

Overloads Public Sub Destroy()
Overloads Public Sub Destroy(
    ByVal cancelAgreements As Boolean);

C#

public void override Destroy();
public void Destroy(
    bool cancelAgreements );

Purpose

Destroy a certified delivery listener.

Parameter

Description
cancelAgreements

true cancels all certified delivery agreements of this listener; certified senders delete from their ledgers all messages sent to this listener.

false leaves all certified delivery agreements in effect, so certified senders continue to store messages.

When absent, the default value is false.

Canceling Agreements

When destroying a certified delivery listener, a program can either cancel its certified delivery agreements with senders, or let those agreements persist (so a successor listener can receive the messages covered by those agreements).

When canceling agreements, each (previously) certified sender transport receives a REGISTRATION.CLOSED advisory. Successor listeners cannot receive old messages.

See Also

CMListener