Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy
	http://www.oracle.com/technology/documentation/index.html   |   Site Map   |   Search   |   PDF Files   |   Contact   |   Glossary
Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo C Function Reference

AEWsetunsol() - post Windows message for BEA Tuxedo unsolicited event

#include <windows.h>
#include <atmi.h>
int far pascal AEWsetunsol(HWND hWnd, WORD wMsg)

In certain Microsoft Windows programming environments it is natural and convenient for the BEA Tuxedo system's unsolicited messages to be posted to the Windows event message queue.

AEWsetunsol() controls which window to notify, hWnd, and which Windows message type to post, wMsg. When a BEA Tuxedo unsolicited message arrives, a Windows message is posted. lParam() is set to the BEA Tuxedo system buffer pointer, or zero if none. If lParam() is non-zero, the application must call tpfree() to release the buffer.

If wMsg is zero, any future unsolicited messages will be logged and ignored.

In a multithreaded application, a thread in the TPINVALIDCONTEXT state is not allowed to issue a call to AEWsetunsol().

Upon failure, AEWsetunsol() returns -1 and sets tperrno() to indicate the error condition.

Upon failure, AEWsetunsol() sets tperrno() to one of the following values.

[TPESYSTEM]

A BEA Tuxedo system error has occurred The exact nature of the error is written to a log file.

[TPEOS]

An operating system error has occurred.

This interface is supported only in Microsoft Windows clients.

AEWsetunsol() posting of Windows messages may not be activated simultaneously with a tpsetunsol()callback routine. The most recent tpsetunsol() or AEWsetunsol() request controls how unsolicited messages will be handled.

tpsetunsol(3c)