AEWsetunsol(3c)

Name

AEWsetunsol()—Posts a Windows message for BEA Tuxedo ATMI unsolicited event.

Synopsis

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

Description

In certain Microsoft Windows programming environments, it is natural and convenient for the BEA Tuxedo ATMI 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 ATMI unsolicited message arrives, a Windows message is posted. lParam() is set to the BEA Tuxedo ATMI 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().

Return Values

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

Errors

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

Portability

This interface is supported only in Microsoft Windows clients.

Notices

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.

See Also