Posts a message to a message queue associated with the thread used to create a specified window. This API function returns the control without waiting for that thread to process the message.

bool AIT_PostMessage  (
  integer nWndHandle,     // Window handle
  integer nMessage,       // Message
  integer nWParam,        // First parameter for a message
  integer nLParam         // Second parameter for a message
);

nWndHandle (input)

Specify a window handle to which to post a message.

The following value has a special meaning.

Value	Description
HWND_BROADCAST	Posts a message to all the top-level windows in the system, including an invalid window not owned, an invisible window not owned, an overlapped window (hidden by another front window), and a pop-up window. Does not post a message to any child windows.

nMessage (input)

Specify a message you want to post.

nWParam (input)

Specify additional information particular to a message.

nLParam (input)

Specify additional information particular to a message.

The return value is true if the function was executed normally, and false if not. If the function has returned false, you can use AIT_GetLastError to acquire an extended error code. The following gives the error codes that AIT_GetLastError may return.

Extended error number	Error code
8	ERROR_NOT_ENOUGH_MEMORY
14	ERROR_OUTOFMEMORY
87	ERROR_INVALID_PARAMETER