###Function###
FileCreateShortcut

###Description###
Creates a shortcut (.lnk) to a file.

###Syntax###
FileCreateShortcut ( "file", "lnk" [, "workdir" [, "args" [, "desc" [, "icon" [, "hotkey" [, icon number [, state]]]]]]] )


###Parameters###
@@ParamTable@@
file
	Full path and file name of file to which the shortcut will point.
lnk
	Full path and file name of the shortcut.
workdir
	[optional] Working directory.
args
	[optional] Additional file arguments.
desc
	[optional] File Description.
icon
	[optional] Full Path/File name of icon to use.
hotkey
	[optional] Hotkey - same as the <a href="Send.htm">Send()</a> key format.
icon number
	[optional] The icon instance to use (usually 0)
state
	[optional] The state the shortcut is launched in.  Use either @SW_SHOWNORMAL, @SW_SHOWMINNOACTIVE or @SW_SHOWMAXIMIZED
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	1.
Failure:	0 if lnk cannot be created.
@@End@@


###Remarks###
Hotkeys for windows shortcuts are of the following form:  Ctrl+Alt+X, Ctrl+Shift+X, Shift+Alt+X, Ctrl+NumPadKey, or Alt+NumPadKey where X represents a letter, number, punctuation, or function key.  If you specify an invalid form, Windows typically defaults to Ctrl+Alt
Note that Windows distinguishes number pad keys from regular number and punctuation keys.  <a href="FileCreateShortcut.htm">FileCreateShortcut()</a> allows you to create Ctrl+X and Alt+X shortcuts (which Windows normally only allows when X is a NumPadKey); however, you should avoid these assignments as they may conflict with standard application hotkeys.
Windows prohibits ESC, ENTER, TAB, SPACEBAR, PRINT SCREEN, SHIFT, or BACKSPACE from being used in hotkeys.

<a href="FileCreateShortcut.htm">FileCreateShortcut()</a> does not require a valid target, workdir, icon, or hotkey in order to "successfully" create the LNK file; however, the destination of the LNK file must be valid!  If the hotkey you choose is already in use, your new shortcut takes precedence.  Also, if you create a shortcut with the same path\name as as a pre-existing shortcut, it gets overwritten with your new version.


###Related###
FileGetShortcut, FileCreateNTFSLink


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