Environment.Close
Method
Visual Basic
Public Shared Sub Close()
C#
public static void Close();
Purpose
Stop and destroy Rendezvous internal machinery.
Remarks
After Environment.Close destroys the internal machinery, Rendezvous software becomes inoperative:
| • | Events no longer arrive in queues. |
| • | All events, queues and queue groups are unusable, so programs can no longer dispatch events. |
| • | All transports are unusable, so programs can no longer send outbound messages. |
After closing the Environment, all events, transports, queues and queue groups associated with that environment are invalid; it is illegal to call any methods of these objects.
After closing the Environment, you can reopen it.
Reference Count
A reference count protects against interactions between programs and third-party packages that call Environment.Open and Environment.Close. Each call to Environment.Open increments an internal counter; each call to Environment.Close decrements that counter. A call to Environment.Open actually creates internal machinery only when the reference counter is zero; subsequent calls merely increment the counter, but do not duplicate the machinery. A call to Environment.Close actually destroys the internal machinery only when the call decrements the counter to zero; other calls merely decrement the counter. In each program, the number of calls to Environment.Open and Environment.Close must match.