ExtractIcon (Windows CE 5.0)

Send Feedback

This function retrieves a handle to an icon from the specified executable file, dynamic-link library (DLL), or icon file.

HICON ExtractIcon(
   HINSTANCE hInst,
   LPCTSTR lpszExeFileName,
   UINT nIconIndex
);

Parameters

  • hInst
    [in] Handle to the instance of the application calling the function.

  • lpszExeFileName
    [in] Pointer to a null-terminated string that specifies the name of an executable file, DLL, or icon file.

  • nIconIndex
    [in] Specifies the zero-based index of the icon to retrieve. For example, if this value is zero (0), the function returns a handle to the first icon in the specified file.

    If this value is 1, the function returns the total number of icons in the specified file. If the file is an executable file or DLL, the return value is the number of RT_GROUP_ICON resources. If the file is an .ICO file, the return value is 1.

Return Value

The return value is a handle to an icon. If the file specified was not an executable file, DLL, or icon file, the return is 1. If no icons were found in the file, the return value is NULL.

Requirements

OS Versions: Windows CE 5.0 and later.
Header: Shellapi.h.
Link Library: Icon.lib.

See Also

Resources Functions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.