[Top] [Prev] [Next] [Bottom]

AEWsetunsol(3)

AEWsetunsol(3)

Name

AEWsetunsol-post Windows message for TUXEDO 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 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 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(3) to release the buffer.

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

Return Values

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

Errors

Under the following conditions, AEWsetunsol() fails and sets tperrno to:

[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.

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

tpsetunsol(3)



[Top] [Prev] [Next] [Bottom]