###User Defined Function###
_WinAPI_LoadIconWithScaleDown

###Description###
Loads an icon and scales down a larger image instead of scaling up a smaller image.

###Syntax###
#include <WinAPISys.au3>
_WinAPI_LoadIconWithScaleDown ( $hInstance, $sName, $iWidth, $iHeight )


###Parameters###
@@ParamTable@@
$hInstance
	Handle to the module of either a DLL or executable (.exe) file that contains the icon to be loaded.
$sName
	The information about the icon to load. If $hInstance is not 0, $sName specifies the icon resource
	either by name or ordinal, otherwise, $sName specifies either the name of a standalone icon (.ico)
	file or the identifier of a predefined icon to load.
	$IDI_APPLICATION
	$IDI_HAND
	$IDI_QUESTION
	$IDI_EXCLAMATION
	$IDI_ASTERISK
	$IDI_WINLOGO
	$IDI_SHIELD
	$IDI_ERROR
	$IDI_INFORMATION
	$IDI_WARNING
$iWidth
	The desired width, in pixels, of the icon.
$iHeight
	The desired height, in pixels, of the icon.
@@End@@

###ReturnValue###
@@ReturnTable@@
Success 	The icon handle.
Failure 	0 and sets the @error flag to non-zero, @extended flag may contain the HRESULT error code.
@@End@@


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

This function requires <strong>Windows Vista or later</strong>.


###Related###
_WinAPI_DestroyIcon


###See Also###
@@MsdnLink@@ LoadIconWithScaleDown


###Example###
@@IncludeExample@@
