Jump back to the top page Jump back to the top page
 

 Home
 What is XXCOPY ?
 Products
 Downloads
 F A Q 
 Order
 Support
 About Us (Pixelab) 
On-Line Manual 
XXTB #001 
XXTB #002 
XXTB #003 
XXTB #004 
XXTB #005 
             . . .  


XXCOPY
Version
3.33.3


Released
2016-10-28
©2016 Copyright
Pixelab

 All rights reserved  
    [ Table of Contents ] [ Show as Detached ] [ >> ]

    XXCOPY TECHNICAL BULLETIN #038

    From:    Kan Yabumoto           tech@xxcopy.com
    To:      XXCOPY user
    Subject: Creating a Shortcut from the command line using XXMKLINK
    Date:    2013-02-28
    ===============================================================================
    
    Introduction:
    
        The Shortcut (a.k.a. Shell Link) is a convenient object in
        Windows' environments that makes everyone's life easier.
    
        It is trivial to create one.  Most Windows users know how.
        Here are just a few common ways:
    
        1.  Inside Windows Explorer, highlight an object (file or
            directory) and then Menu > File > Create Shortcut,
            and Bingo!!!   Or, once you have an object highlighted,
            clicking the right mouse button will give you a floating
            menu that has the "Create Shortcut" option.
    
        2.  Windows Explorer also offers the Menu > File > New > Shortcut
            that opens the "Create Shortcut" wizard which will assist
            you from there.  Alternatively, you may place the mouse
            cursor where you want a new shortcut and obtain the floating
            menu by right mouse click for the New > Shortcut sequence.
     
        Once you create a shortcut, you can further customize the
        appearance and behavior of the shortcut via the property sheet.
    
    
    From a script (batch file):
    
        Now, the batch file is a useful way to automate a lot of things.
        Naturally, it would be useful to automate the process of making
        a shortcut using a batch file.  But, we have not seen such
        a tool that can be invoked from a batch file.  In my estimation,
        this is due to the fact that there is no straightforward method
        in the Win32 API.
    
        Creating a shortcut is not an everyday thing.  Also the ordinary
        method of making a shortcut is quite easy.  For these reasons, I don't
        expect many people to find this tool very useful.  But, if you are
        an IT professional whose job is to setup a computer environment for
        novice users, you may find this tool useful.  Because automation is
        a key to their work efficiency, a utility that can be easily
        incorporated into a batch file may find some audience.
    
    
    Enter XXMKLINK:
    
        With XXMKLINK, you can write a batch file for software
        installation which has been done by specialized installation
        programs.  Basically, XXMKLINK is a tool that gathers various
        information from a command line and packages it into a shortcut.
    
      Command syntax of XXMKLINK:
    
        xxmklink spath opath [ arg [ wdir [ desc [ mode [ icon[:n] ]]]]]
    
        where 
        
          spath     path of the shortcut (.lnk added as needed)
          opath     path of the object represented by the shortcut
          arg       argument string (use quotes with space, see below)
          wdir      path of the working directory (for "Start in")
          desc      description string (shown in Shortcut's Properties)
          mode      display mode (1:Normal [default], 3:Maximized, 7:Minimized)
          icon[:n]  icon file [with optional icon index value n]
    
          In addition to the above, the following switches are supported
          which can be placed in any position in the command line.
    
          /p        prompts before action
          /q        no output when successful (quiet)
          /e        checks error condition strictly
          /a        enables Run as Administrator (set in the checkbox)
                    the /a switch is supported by V.2.00 or higher.
    
        Note:
    
          Switches (whose first character is always slash) can be placed in
          any position of the command argument.  A string that starts with
          a slash as a non-switch argument must be surrounded by a pair of
          double-quotes (").  It is recommended that the XXMKLINK's switches
          be placed before or after the non-switch arguments for clarity.
    
          Make sure that each element is surrounded by a pair of
          double-quotes (") if embedded space is present.
    
          The third field (arg) is for the argument string for the object
          (typically a program that requires command arguments) that must
          be entered as one string here, even if it has many parts that are
          separated by spaces and possibly with double-quote characters.
    
          When double-quoted string has an embedded double-quote,
          add a backslash in front of each embedded double-quote.
    
          Use an empty string (two consecutive double-quotes) as a
          place holder since this command syntax is sensitive to the
          order of the field, optional switches cannot alter the
          predetermined order as defined by the program.
    
          When an invalid display mode is specified (not 1, 3 nor 7),
          the default (Normal Window) value will be used.
    
          When the icon specifier does not point to an existing file,
          the icon field will be ignored.
    
          When the /e switch is present, any error condition will
          result in a failure in creating the shortcut.  The default
          behavior (without /e) which forgives minor error conditions
          (e.g., missing icon file or invalid icon index) is probably
          the preferred outcome in most cases.
    
          Special cares must be taken when the % character is embedded
          in the path specifier because it has special meaning to the
          command processor (CMD.EXE) --- See below for examples.
    
          The /a switch is supported in XXMKLINK 2.00 (available with
          an explicit license agreement)  Please contact Pixelab.
    
    
      Examples of XXMKLINK command line:
    
          xxmklink "c:\Program Files\mydir\My Shortcut.lnk" c:\boot.ini
    
             At least two arguments are always needed.
    
    
          xxmklink c:\myauto c:\autoexec.bat "/q" . "I say \"Hello.\""
    
             When the shortcut path is specified without the ".lnk"
             extension, it will be automatically supplied since
             all shortcuts must be so named.  Note that the third
             argument string, "/q" is entered as a quoted string.  If
             it were without the quotation marks, it would be treated
             as the xxmklink switch, /q, not the argument string for
             the object program.
    
    
          xxmklink myshortcut %systemroot%\explorer.exe "" c:\
    
             When this command is run either directly from the command
             line or from a batch file, the %systemroot% part will be
             replaced by the command line processor (CMD.EXE) immediately
             (before XXMKLINK.EXE has chance to see it) to something
             like C:\WINDOWS which is supplied by the environment variable.
    
    
          xxmklink myshortcut %%systemroot%%\explorer.exe "" c:\
    
             When you want the literal string, %systemroot% to be kept
             in the shortcut setting, this command line should be run
             from a batch file where the "escape sequence" (%%) will
             protect the %systemroot% string from the Environment variable
             substitution mechanism.  Note that this command line is
             still subject to the substitution when run directly from the
             command line resulting in an undesired outcome.  
    
    
    Download XXMKLINK:
    
         XXMKLINK is available for personal use without charge.
    
         The URL below is for XXMKLINK Ver 1.00.
    
            http://www.xxcopy.com/download/xxmklink.zip
    
    
         If you intend to include the XXMKLINK program in your product
         for distribution, please obtain a written permission from
         Pixelab, first.  We do charge a nominal fee for commercial
         distribution.
    
    	 Please contact Pixelab (sales@pixelab.com) for the latest version.
    
    
    
    [ Table of Contents ] [ Show as Detached ] [ >> ]