ATMI C Function Reference
|
 |
 |
|
 |
 |
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.
