Public Interface QABinaryMessage Inherits QAMessage

public interface QABinaryMessage : QAMessage

• QAMessage interface [QAnywhere .NET]

All members of QABinaryMessage interface, including all inherited members.

It inherits from the QAMessage class and adds a bytes message body. QABinaryMessage provides a variety of functions to read from and write to the bytes message body.

When the message is first created, the body of the message is in write-only mode. After a message has been sent, the client that sent it can retain and modify it without affecting the message that has been sent. The same message object can be sent multiple times.

When a message is received, the provider has called QABinaryMessage.Reset() so that the message body is in read-only mode and reading of values starts from the beginning of the message body.

The following example uses the QABinaryMessage writeString function to write the string "Q" followed by the string "Anywhere" to a QABinaryMessage instances message body.

// create a binary message instance
QABinaryMessage binary_message;
binary_message = qa_manager.CreateBinaryMessage();

// set optional message properties ...
binary_message.ReplyToAddress = "my-queue-name";

// write to the message body
binary_message->WriteString("Q");
binary_messge->WriteString("Anywhere");

// put the message in the local database, ready for sending
if(!qa_manager->putMessage( "store-id\\queue-name", msg )) {
	    handleError();
	}

The message is sent by the QAnywhere Agent. On the receiving end, the first QABinaryMessage.ReadString invocation returns "Q", and the next QABinaryMessage.ReadString invocation returns "Anywhere".

For more information, see Determining when message transmission should occur on the client and How to write QAnywhere client applications.