DOCERR: Don't Call Destroy Function on Loaded Cursor or Icon

Last reviewed: July 23, 1997
Article ID: Q84779
3.10 WINDOWS kbprg kbdocerr

The information in this article applies to:

  • Microsoft Windows Software Development Kit (SDK) for Windows version 3.1

SUMMARY

The "Microsoft Windows Software Development Kit: Programmer's Reference, Volume 2: Functions" manual contains an error regarding the proper use of the DestroyCursor and DestroyIcon functions. This error is repeated a number of times throughout the manual. This article lists the various changes required to correct the error.

The manual states that when an application loads a cursor using the LoadCursor function, it should delete the cursor using the DestroyCursor function. Likewise, the manual states that when an application loads an icon using the LoadIcon function, it should delete the icon using the DestroyIcon function. These two statements are incorrect. DestroyCursor is used only on cursors created with the CreateCursor function and DestroyIcon is used only on icons created with the CreateIcon function.

To address this problem, make the following four changes to the "Microsoft Windows SDK: Programmer's Reference, Volume 2: Functions" manual:

  • On page 216, modify the documentation for the DestroyCursor function to remove the reference to LoadCursor.
  • On page 216, modify the documentation for the DestroyIcon function to remove the reference to LoadIcon.
  • On page 576, modify the documentation for the LoadCursor function to replace the following line

          An application should use the DestroyCursor function to destroy
          any private cursors it loads.
    

    with the following line:

          An application should use the DestroyCursor function to destroy
          any private cursors it creates with the CreateCursor function.
    
  • On page 577, modify the documentation for the LoadIcon function to replace the following line

          An application should use the DestroyIcon function to destroy
          any private icons it loads.
    

    with the following line:

          An application should use the DestroyIcon function to destroy
          any private icons it creates using the CreateIcon function.
    


Additional reference words: 3.10
KBCategory: kbprg kbdocerr
KBSubcategory: UsrRsc
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 23, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.