FileGetShortcut()

FileGetShortcut() Retrieves information about a shortcut (.lnk) file, such as its target file.

Mfunc.FileGetShortcut(LinkFile [, OutTarget, OutDir, OutArgs, OutDescription, OutIcon, OutIconNum, OutRunState])

Parameters

LinkFile

Name of the shortcut file to be analyzed, which is assumed to be in %A_WorkingDir% if an absolute path isn't specified. Be sure to include the .lnk extension.

OutTarget

Name of the variable in which to store the shortcut's target (not including any arguments it might have). For example:
C:\WINDOWS\system32\notepad.exe

OutDir

Name of the variable in which to store the shortcut's working directory. For example: C:\My Documents. If environment variables such as %WinDir% are present in the string, one way to resolve them is via StringReplace. For example: StringReplace, OutDir, OutDir, %WinDir%, %A_WinDir%

OutArgs

Name of the variable in which to store the shortcut's parameters (blank if none).

OutDescription

Name of the variable in which to store the shortcut's comments (blank if none).

OutIcon

Name of the variable in which to store the filename of the shortcut's icon (blank if none).

OutIconNum

Name of the variable in which to store the shortcut's icon number within the icon file (blank if none). This value is most often 1, which means the first icon.

OutRunState

Name of the variable in which to store the shortcut's initial launch state, which is one of the following digits:
1: Normal
3: Maximized
7: Minimized

Throws

Throws MfException throw any errors with InnerException set to the Autohotkey - FileGetShortcut error message.
Throws MfException any other general error occurs.

Remarks

Wrapper for AutoHotkey Docs - FileGetShortcut.
Static method.

Any of the output variables may be omitted if the corresponding information is not needed.

Any and/or all parameter for this function can be instance of MfString or var containing string.

Example

file := Mfunc.FileSelectFile(32,, "Pick a shortcut to analyze.", "Shortcuts (*.lnk)")
if file =
return

Mfunc.FileGetShortcut(file, OutTarget, OutDir, OutArgs, OutDesc, OutIcon, OutIconNum, OutRunState)
MsgBox %OutTarget%`n%OutDir%`n%OutArgs%`n%OutDesc%`n%OutIcon%`n%OutIconNum%`n%OutRunState%