# Function Reference

# _WinAPI_CopyIcon

Copies the specified icon from another module

#include <WinAPIIcons.au3>
_WinAPI_CopyIcon ( $hIcon )

## Parameters

$hIcon | Handle to the icon to be copied

## Return Value

Success: | The handle to the duplicate icon
Failure: | 0, call _WinAPI_GetLastError() to get extended error information

## Remarks

The CopyIcon function enables an application or DLL to get its own handle to an icon owned by another module.
If the other module is freed, the application icon will still be able to use the icon.
Before closing, call the _WinAPI_DestroyIcon() function to free any system resources associated with the icon.

## Related

_WinAPI_DestroyIcon

## See Also

Search CopyIcon in MSDN Library.