Retrieves information about a shortcut (.lnk) file, such as its target file.
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. To expand any environment variables that might be present (such as %windir%), follow this example: Transform, OutDir, Deref, %OutDir% |
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 |
ErrorLevel
If there was a problem -- such as LinkFile not existing -- all the output variables are made blank and ErrorLevel is set to 1. Otherwise, ErrorLevel is set to 0.
Remarks
Any of the output variables may be omitted if the corresponding information is not needed.
Related
Example
FileSelectFile, file,,, Pick a shortcut to analyze., Shortcuts (*.lnk) if file = return FileGetShortcut, %file%, OutTarget, OutDir, OutArgs, OutDesc, OutIcon, OutIconNum, OutRunState Transform, OutDir, Deref, %OutDir% ; Resolve any environment variables, such as %WinDir%. MsgBox %OutTarget%`n%OutDir%`n%OutArgs%`n%OutDesc%`n%OutIcon%`n%OutIconNum%`n%OutRunState%