HP-UX SNAplus2 CPI-C Programmer's Guide (June 2003)

Concepts
Nonblocking Operation
Chapter 160
• Cancel_Conversation
• Deallocate
As an alternative to using Specify_Windows_Handle or
WinCPICSetEvent() as described previously, the application can use
Wait_For_Conversation, as for HP-UX systems. This function is provided
for Windows systems to assist in migrating applications from other
operating system environments. However, the use of blocking functions
such as Wait_For_Conversation in the Windows environment is strongly
discouraged. If you are writing a new application specifically for the
Windows environment, use Specify_Windows_Handle and not
Wait_For_Conversation.
NOTE
• Check_For_Completion, described previously for HP-UX systems, is
not supported on Windows systems.
• If the application uses one of the calls listed previously in
nonblocking mode while Receive is outstanding, it must use
Specify_Windows_Handle. It must not issue Wait_For_Conversation
if another call is outstanding in addition to Receive; the results of
this call are undefined if more than one call is outstanding on the
same conversation.
End of Section