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
- Microsoft Visual C++ 2.0 Professional Edition
This article was previously published under Q121665
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