Class: TCaucusSendMessage

Declaration: Caucus.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

None.

Inherited By:

None.

Purpose:

TCaucusSendMessage is used to send a message to a caucus. The client sends a message by creating a TCaucusSendMessage object, streaming data in to it, and destroying the object. There is no limit on the size of the message that can be sent. Zero-byte messages are allowed.

Instantiation:

Always allocate on the stack.

Deriving Classes:

Do not derive from this class.

Concurrency:

Multithread safe.

Resource Use:

No special requirements.

Member Function: TCaucusSendMessage::TCaucusSendMessage

TCaucusSendMessage (TCaucusMember * memberAlias)

Interface Category:

API.

Purpose:

Creates a new TCaucusSendMessage to send a message for the specified member. Initiates the send operation.

Calling Context:

Called by the caucus member sending the message.

Parameters:

TCaucusMember * memberAlias -The sender of the message. It must not be NIL.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Multithread safe.

Other Considerations:

Allocate on stack.

Member Function: TCaucusSendMessage::~TCaucusSendMessage

~ TCaucusSendMessage ()

Interface Category:

API.

Purpose:

Destructor.

Calling Context:

Called to destroy an object.

Parameters:

Takes no parameters.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Multithread safe.

Other Considerations:

The destructor causes the message to be sent by calling the TCaucusMember's EndSend member function.

Member Function: TCaucusSendMessage::operatorTStream&

operator TStream & () const

Interface Category:

API.

Purpose:

Returns the stream used to send the message.

Calling Context:

You do not need to call this function directly. The compiler should generate a stream conversion operator for you when you stream data into this object.

Parameters:

Takes no parameters.

Return Value:

Returns the stream used to send the message.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Multithread safe.

Other Considerations:

There might be times when you need to explicitly call this conversion operator directly (for example, if the compiler doesn't or cannot do it for you).

Click the icon to mail questions or corrections about this material to Taligent personnel.