When PostMessage() Will Return 0, Indicating Failure

 Last reviewed: July 22, 1997
Article ID: Q36584
3.00 3.10 WINDOWS kbprg

The information in this article applies to:

  • Microsoft Windows Software Development Kit (SDK) for Windows versions 3.1 and 3.0

PostMessage(hWnd,wMsg,wParam,lParam) returns 0, indicating failure, for one of the following two reasons:

  1. The window handle (hWnd parameter to PostMessage()) receiving the message is -1. If this is the case, the message (wMsg) is broadcast to all windows.

  2. The window to receive the message has a full application queue.

Note that PostMessage() does not return NULL if the hWnd parameter in the PostMessage() call is an invalid window handle. Also note that IsWindow() can be called to verify whether a given handle is indeed a valid window handle.

Additional reference words: 3.10
KBCategory: kbprg
KBSubcategory: UsrMsg
Keywords : kb16bitonly

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: July 22, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.