HP-UX SNAplus2 R7 APPC Programmer's Guide

Writing Transaction Programs
APPC Entry Points: Windows Systems
Supplied Parameters
The supplied parameter is:
Handle
The handle that was returned on the original WinAsyncAPPC call for the verb.
Returned Values
The return value from the function is one of the following:
0
(zero)
The outstanding verb was canceled successfully.
WAPPCINVALID
The supplied parameter did not match the handle of any outstanding APPC verb.
WAPPCALREADY
The APPC verb identified by the supplied handle has already completed. (The application may already
have processed the message resulting from the verb completion, or the message may still be waiting in the
application’s message queue.)
Usage
In addition to canceling the outstanding verb, APPC may also end the conversation or TP on which the verb was
issued, bring down the session, or both. The action taken depends on the verb that was canceled. APPC also posts
a message to the application indicating completion of the canceled verb; the primary return code for the verb is
AP_CANCELLED.
2.4.5 WinAPPCCleanup
The application uses the WinAPPCCleanup function to unregister as a Windows APPC user, after it has finished
issuing APPC verbs.
Function Call
BOOL WINAPI WinAPPCCleanup (void);
Supplied Parameters
No parameters are supplied with the WinAPPCCleanup function.
Returned Values
The return value from the function is one of the following:
TRUE
The application was unregistered successfully.
FALSE
An error occurred during processing of the call, and the application was not unregistered. Check the log files
for messages indicating the cause of the failure.
2.4.6 Blocking Verbs
This section describes how blocking verbs operate in the Win16 environment, or in the Win32 environment if
the calling application is single-threaded, and provides information that you need to be aware of when writing
applications to use blocking verbs. (Typically a Win32 application would use multiple threads to avoid the problem
of a blocking verb blocking the entire application.)
59