###User Defined Function###
_WinAPI_CopyIcon

###Description###
Copies the specified icon from another module

###Syntax###
#include <WinAPI.au3>
_WinAPI_CopyIcon ( $hIcon )


###Parameters###
@@ParamTable@@
$hIcon
	Handle to the icon to be copied
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	The handle to the duplicate icon
Failure:	0, call <a href="_WinAPI_GetLastError.htm">_WinAPI_GetLastError()</a> to get extended error information
@@End@@


###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 <a href="_WinAPI_DestroyIcon.htm">_WinAPI_DestroyIcon()</a> function to free any system resources associated with the icon.


###Related###
_WinAPI_DestroyIcon


###See Also###
@@MsdnLink@@ CopyIcon
