WinHLLAPIAsync

Top  Previous  Next

This entry point is used for six WinHLLAPI functions that often take a long time to complete. With WinHLLAPIAsync, the function will be launched asynchronously and will not interfere with the continued progression of the calling application.

 

These functions are:

 

Receive File (91)
Start Close Intercept (41)
Send File (90)
Start Host Notify (23)
Start Keystroke Intercept (50)
Wait (04)

 

 

Syntax

 

HANDLE WinHLLAPIAsync (HWIND hWnd, LPWORD lpnFunction, LPBYTE lpData, LPWORD lpnLength, LPWORD lpnRetC)*

 

The parameter list is the same as WinHLLAPI except a window handle is required before the function number. Since the function operates asynchronously, its completion is signaled by a registered message. The window handle is required as the target of the message.

 

There are two messages that must be registered by the WinHLLAPI application through calls to RegisterWindowsMessage() with the strings WinHLLAPIAsync(for all functions except 90 and 91) and WinHLLAPIAsyncFileTransfer (for functions 90 and 91). The standard format is as follows:

 

WPARAM

 

Contains the Task Handle returned by the original function call.

 

LPARAM

 

The high word contains the error code and the low word contains the original function number.