WinAsyncNOF()

This function provides an asynchronous entry point for all of the Node Operator Facility verbs.

Syntax

HANDLE WINAPI WinAsyncNOF(HWND hWnd,
                          long vcb,
                          unsigned short vcb_size)

Parameters

hWnd: Window handle to receive completion message.
vcb: Pointer to verb control block.
vcb_size: Number of bytes in the verb control block.

Returns

The return value specifies whether the asynchronous request was successful. If the function was successful, the actual return value is a handle. If the function was not successful, a zero is returned.

Remarks

Each application thread can only have one outstanding request at a time when using this entry point.

When the asynchronous operation is complete, the application's window hWnd receives the message returned RegisterWindowMessage with “WinAsyncNOF” as the input string. The wParam argument contains the asynchronous task handle returned by the original function call.

If the function returns successfully, a WinAsyncNOF() message will be posted to the application when the operation completes or the conversation is canceled.

Note: See also WinNOFCancelAsyncRequest() on page WinNOFCancelAsyncRequest().