HP-UX SNAplus2 R7 APPC Programmer's Guide

Writing Transaction Programs
APPC Entry Points: Windows Systems
Usage
In addition to canceling the outstanding verb, APPC also ends the conversation on which the verb was issued
and brings down the session. If the verb is one that relates to a TP rather than to a conversation (such as
RECEIVE_ALLOCATE or TP_STARTED), APPC ends the TP.
2.4.9 WinAPPCIsBlocking
The application uses the WinAPPCIsBlocking function to check whether there is a blocking APPC verb
outstanding (a verb issued using the APPC entry point).
Function Call
BOOL WINAPI WinAPPCIsBlocking (void);
Supplied Parameters
No parameters are supplied with this function.
Returned Values
The return value from the function is one of the following:
TRUE
A blocking APPC verb is outstanding. If necessary, the application can use the WinAPPCCancelBlock-
ingCall function to cancel it.
FALSE
A blocking APPC verb is not outstanding.
2.4.10 WinAPPCSetBlockingHook
The application uses this call to specify its own blocking function, which APPC will use instead of the default
blocking function. For more information about how the blocking function operates and on the functions it must
perform, see Section 2.4.6,
Blocking Verbs.
Function Call
FARPROC WINAPI WinAPPCSetBlockingHook (FARPROC lpBlockFunc);
Supplied Parameters
The supplied parameter is:
lpBlockFunc
The procedure instance address of the application’s blocking function. The application should use the
MakeProcInstance call to obtain this address; refer to your Windows documentation for more information.
Returned Values
The return value is the procedure instance address of the previous blocking function. If the application is using
more than one blocking function, and will need to restore the previous blocking function later, it should save
this address; it can then issue WinAPPCSetBlockingHook again using the saved value, to restore the previous
blocking function. If it is using only one blocking function, or will not need to restore the previous value, it can
ignore the return value from this call.
Usage
The new blocking function remains in effect until the application issues one of the following calls:
62