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

CPI-C Calls
WinCPICSetBlockingHook
Chapter 3306
WinCPICSetBlockingHook
For Windows The application uses this call to specify its own blocking function, which
CPI-C 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 “Blocking Calls” in Chapter 2.
Function Call
FARPROC WINAPI WinCPICSetBlockingHook (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 WinCPICSetBlockingHook()
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:
• WinCPICSetBlockingHook() (with a different procedure instance
address), to specify a new blocking function or to restore a previous
one