DuplicateIcon function

Creates a duplicate of a specified icon.

Syntax

HICON DuplicateIcon(
  HINSTANCE hInst,
  HICON     hIcon
);

Parameters

hInst

Type: HINSTANCE

hIcon

Type: HICON

Handle to the icon to be duplicated.

Return Value

Type: HICON

If successful, the function returns the handle to the new icon that was created; otherwise, NULL.

Remarks

When it is no longer needed, the caller is responsible for freeing the icon handle returned by DuplicateIcon by calling the DestroyIcon function.

Requirements

   
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shellapi.h
DLL Shell32.dll