This function gets, waiting if necessary, a message from the thread's message queue and returns when a message conforming to the filtering criteria is available.

#define INCL_WINMESSAGEMGR /* Or use INCL_WIN, INCL_PM, Also in COMMON section */
#include <os2.h>

HAB      hab;         /*  Anchor-block handle. */
PQMSG    pqmsgmsg;    /*  Message structure. */
HWND     hwndFilter;  /*  Window filter. */
ULONG    ulFirst;     /*  First message identity. */
ULONG    ulLast;      /*  Last message identity. */
BOOL     rc;          /*  Continue message indicator. */

rc = WinGetMsg(hab, pqmsgmsg, hwndFilter,
       ulFirst, ulLast);