Microsoft KB Archive/121665

= INFO: GetDescendantWindow - bOnlyPerm Parameter Incorrect =

Article ID: 121665

Article Last Modified on 12/2/2003

-

APPLIES TO

 Microsoft Foundation Class Library 4.2, when used with:  Microsoft Visual C++ 1.0 Professional Edition

 Microsoft Visual C++ 1.5 Professional Edition

 Microsoft Visual C++ 1.51

 Microsoft Visual C++ 1.0 Professional Edition</li></ul>

 Microsoft Visual C++ 2.0 Professional Edition</li></ul>

 Microsoft Visual C++ 2.1</li></ul>

 Microsoft Visual C++ 2.2</li></ul> </li></ul>

-

<div class="notice_section">

This article was previously published under Q121665

<div class="summary_section">

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 query words: 1.00 1.50 2.00 2.10 2.50 2.51 3.00 4.00

Keywords: kbbug kbuidesign kbvc400fix kbdocfix kbdocerr KB121665

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.