Partager via


LoadIconW_I (Windows CE 5.0)

Send Feedback

This function loads the specified icon resource from the executable (.exe) file associated with an application instance.

HICON WINAPI LoadIconW_I(HINSTANCE hinst,PCTSTR pszIcon);

Parameters

  • hinst
    [in] Handle to an instance of the module for which the executable file contains the icon that you want to load. This parameter must be NULL when you load a standard icon.
  • pszIcon
    [in] Pointer to a null-terminated string that contains the name of the icon resource that you want to load. Alternatively, this parameter can contain the resource identifier in the low-order word and zero in the high-order word. Use the MAKEINTRESOURCE macro to create this latter value.

Return Values

A handle to the newly loaded icon indicates success. NULL indicates failure. To get extended error information, call GetLastError.

Remarks

LoadIconW_I loads the icon resource only if you did not load the icon resource previously; otherwise, LoadIconW_I retrieves a handle to the existing resource. The function searches within the icon resource for the icon most appropriate for the current display. The icon resource can be a color or monochrome bitmap.

LoadIconW_I can only load an icon whose size conforms to the SM_CXICON and SM_CYICON system metric values. Use the LoadImage function to load icons of other sizes.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Gwebypasscoredllthunk.hpp.

See Also

GetSystemMetrics | LoadIcon | LoadImage | MAKEINTRESOURCE

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.