Microsoft KB Archive/68988

CreateIcon and CreateCursor Documentation Incomplete ID Number: Q68988

3.00 WINDOWS docerr

Summary:

The documentation for the CreateCursor and CreateIcon functions in chapter 4 of the “Microsoft Windows Software Development Kit Reference Volume 1” is not complete. These functions must only be used to create cursors and icons in the dimensions supported by the current display driver.

The GetSystemMetrics function provides the supported dimensions to an application. To determine the proper width and height of an icon, use the SM_CXICON and SM_CYICON parameters, respectively. To determine the proper width and height of a cursor, use the SM_CXCURSOR and SM_CYCURSOR parameters, respectively. For more information on GetSystemMetrics, see page 4-212 of the SDK reference manual.

Creating a cursor or icon that has an unsupported size can terminate the application with an unrecoverable application error (UAE).