WinAPPCSetBlockingHook()
This function enables an APPC implementation of the APPC API to block APPC function calls.
Personal Communications and Communications Server provides this function for compatibility with existing applications.
Syntax
FARPROC WINAPI WinAPPCSetBlockingHook(FARPROC IpBlockFunc);Parameters
- IpBlockFunc
- Specifies the procedure instance address of the blocking function to be installed.
Returned Values
The return value points to the procedure instance of the previously installed blocking function. The application or library that calls the SetBlockingHook function should save this return value so that it can be restored if needed. (If nesting is not important, the application can simply discard the value returned by WinAPPCSetBlockingHook() and eventually use WinAPPCUnhookBlockingHook to restore the default mechanism.)
Usage Notes
A blocking function returns FALSE if it receives a WM_QUIT message so that Personal Communications can return control to the application to process the message and terminate gracefully. Otherwise, the function returns TRUE.
No default blocking hook is implemented. If an application does not set a blocking hook, the application thread waits indefinitely for the blocking call to return.
If the blocking hook function does not return TRUE, returns the blocking verb to the application with the primary return code AP_CANCELLED.
This function is implemented by thread. It provides for a particular thread to replace the blocking mechanism without affecting other threads.
- This is not supported for Win32® SNA API clients.