DOC: GetDescendantWindow - bOnlyPerm Parameter Incorrect

 Last reviewed: July 10, 1997
Article ID: Q121665
1.00 1.50 1.51 | 1.00 2.00 
WINDOWS        | WINDOWS NT
kbprg kbui kbdocerr kbdocfix

The information in this article applies to:

  • The Microsoft Foundation Classes, included with: 

        - Microsoft Visual C++ for Windows, versions 1.0, 1.5, and 1.51
    - Microsoft Visual C++, 32-bit edition, versions 1.0 and 2.0

SUMMARY

The documentation for CWnd::GetDescendantWindow incorrectly states: 

   bOnlyPerm - Specifies whether the window to be returned can be
   temporary. If TRUE, the function can return a temporary window;
   if FALSE, only a permanent window can be returned. For more information
   on temporary windows see Technical Note 3 under MFC in Books Online.
The behavior, as the parameter's name implies, is the opposite of how it is documented. The documentation for the bOnlyPerm parameter should state: 

   bOnlyPerm - Specifies whether the window to be returned must be
   permanent. If TRUE, the function will return a pointer to a permanent
   CWnd object or NULL; if FALSE, the function can return a pointer to a
   temporary CWnd object. For more information on temporary windows
   see MFC Technical Note #3.
NOTE: This problem was fixed in Microsoft Visual C++, 32-bit Edition, version 4.0. The 4.0 Books On-Line entry for CWnd::GetDescendantWindow() correctly documents the meanings of the various bOnlyPerm parameter values.

Additional reference words: 1.00 1.50 2.00 2.10 2.50 2.51 3.00 4.00
KBCategory: kbprg kbui kbdocerr kbdocfix
KBSubcategory: MfcUI
Keywords : MfcUI kbdocerr kbdocfix kbprg kbui
Technology : kbMfc
Version : 1.00 1.50 1.51 | 1.00 2.00
Platform : NT WINDOWS

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 10, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.