IDDEEndEvent

The IDDEEndEvent class provides event information to a server application when a conversation is ended or ending.

An object of this class is created when an IDDETopicServer object needs to notify the application that a conversation is ending or ended. You do not construct objects of this class.


IDDEEndEvent - Member Functions and Data by Group

Constructors & Destructor

You can construct and destruct objects of this class, although normally you never need to do so. These events are usually created and deleted for you by IDDETopicServer objects.


[view class]
~IDDEEndEvent
public:
~IDDEEndEvent()

Supported Platforms

Windows OS/2 AIX
Yes Yes No


[view class]
IDDEEndEvent
public:
IDDEEndEvent(const IEvent& ddeEvent, Source endSource)

Supported Platforms

Windows OS/2 AIX
Yes Yes No


Event Information

Use these members and enumerations to determine the initiator or cause of the conversation termination.


[view class]
sourceOfEnd
public:
Source sourceOfEnd() const

Returns one of the values of the IDDEEndEvent::Source enumeration indicating the source of the ending of the conversation.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


IDDEEndEvent - Enumerations


[view class]
Source
enum Source { client, 
              server, 
              error }

The following enumerations are used to define the possible sources of an end to a conversation:

client
Indicates that the client initiated the conversation's end.
server
Indicates that the server initiated the conversation's end.
error
Indicates that an error in a routine entered from the dispatcher would cause an exception to be thrown and the application would not have an opportunity to catch the exception. Because this situation could cause this application and the application being conversed with to abnormally end, this application is called back with an IDDEEndEvent object. The conversation is also terminated at this point.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


IDDEEndEvent - Inherited Member Functions and Data

Inherited Public Functions

IEvent

Inherited Public Data

Inherited Protected Functions

Inherited Protected Data