###User Defined Function###
_WinAPI_ExtractIcon

###Description###
Extracts an icon from the specified executable file, DLL, or icon file.

###Syntax###
#include <WinAPIRes.au3>
_WinAPI_ExtractIcon ( $sIcon, $iIndex [, $fSmall = 0] )


###Parameters###
@@ParamTable@@
$sIcon
	The name of an executable file, DLL, or icon file from which icons will be extracted.
$iIndex
	The 0-based index of the icon to extract.
	If this value is a negative number, the function extracts the icon whose resource identifier is equal to the absolute value of $iIndex.
$fSmall
	[optional] Specifies whether to extract a small icon, valid values:
		True   - Extract a small icon.
		False  - Extract a large icon (Default).
@@End@@

###ReturnValue###
@@ReturnTable@@
Success 	the handle to the extracted icon.
Failure 	0.
@@End@@


###Remarks###
When you are finished using the icon, destroy it using the <a href="_WinAPI_DestroyIcon.htm">_WinAPI_DestroyIcon()</a> function.


###Related###
_WinAPI_DestroyIcon


###See Also###
@@MsdnLink@@ ExtractIconEx
