Utility to Create a Link (Shortcut)

Introduction

“Shortcut” is a small utility to create links on the Start Menu, Start->Program Menu, or on the Desktop. Most of the time, the only type of application that touches the Start menu is an installation program. You may want to add items to the Start menu if you think they will help users too. In a few cases, you might want to add some functionality to the Start menu, similar to the Documents submenu. The Start Menu is not much more than a special view of a few special purpose directories. All the items in the Start Menu should be links or directories. The shell builds the Start menu by reading the entries in the All Users\Start Menu and <User Name>\Start Menu directories. Any files that show up in these directories automatically appear in the Start Menu.

Source Code

IShellLink encapsulates everything about a link. The physical manifestation of IShellLink is a .lnk file. IShellLink exposes interfaces that let you do everything from create the link and command line to resolve the link back to the actual item. From an active IShellLink object, you can call QueryInterface() to get an IPersistFile instance. This IPersistFile instance will allow you to save the link to disk.

Add the following statement of code in OnInitDialog().

CoInitialize(NULL) ;    // To initialize the COM library on the
                        // current thread

Call CreateLink(int nFolder) to create the link in a specified location. nFolder can be any one of the following values:

  • CSIDL_STARTMENU—To add an Menu item in Start Menu.
  • CSIDL_PROGRAMS—To add an Menu item in Start->Program Menu.
  • CSIDL_DESKTOP—To add a link on the Desktop.
void CShortcutDlg::CreateLink(int nFolder)
{
   UpdateData(TRUE) ;
   //Check for empty strings ...
   if(m_strItem.IsEmpty() || m_strFile.IsEmpty())
   {
      AfxMessageBox("Please,enter the Menu Item and File name
                     correctly.") ;
      return ;
   }

   //File system directory that contains the directories for the
   //common program groups that appear on the Start menu for all
   // users.
   LPITEMIDLIST pidl;

   // Get a pointer to an item ID list that represents the path
   // of a special folder
   HRESULT hr = SHGetSpecialFolderLocation(NULL, nFolder, &pidl);

   // Convert the item ID list's binary representation into a file
   // system path
   char szPath[_MAX_PATH];
   BOOL f = SHGetPathFromIDList(pidl, szPath);

   // Allocate a pointer to an IMalloc interface
   LPMALLOC pMalloc;

   // Get the address of our task allocator's IMalloc interface
   hr = SHGetMalloc(&pMalloc);

   // Free the item ID list allocated by SHGetSpecialFolderLocation
   pMalloc->Free(pidl);

   // Free our task allocator
   pMalloc->Release();

   CString      szLinkName = m_strItem ;
   szLinkName+= _T(".lnk") ;

   CString m_szCurrentDirectory = szPath ;// "D:\\Documents and
                                  Settings\\Administrator\\Start Menu";

   CString szTemp = szLinkName;
           szLinkName.Format( "%s\\%s", m_szCurrentDirectory, szTemp );


        HRESULT hres = NULL;
        IShellLink* psl = NULL;

        // Get a pointer to the IShellLink interface.
        hres = CoCreateInstance(CLSID_ShellLink, NULL,
            CLSCTX_INPROC_SERVER, IID_IShellLink,
            reinterpret_cast<void**>(&psl));
        if (SUCCEEDED(hres))
        {
            IPersistFile* ppf = NULL;

            // Set the path to the shortcut target
            psl->SetPath(m_strFile);

            // Query IShellLink for the IPersistFile interface for
            // saving the shortcut in persistent storage.
            hres = psl->QueryInterface(IID_IPersistFile,
                reinterpret_cast<void**>(&ppf));

            if (SUCCEEDED(hres))
            {
                WCHAR wsz[MAX_PATH];

                // Ensure that the string is ANSI.
                MultiByteToWideChar(CP_ACP, 0, szLinkName, -1,
                    wsz, MAX_PATH);

                // Save the link by calling IPersistFile::Save.
                hres = ppf->Save(wsz, TRUE);
                ppf->Release();
            }
            psl->Release();
        }

   UpdateData(FALSE) ;
}

How to use Shortcut

Using the “Shortcut” utility is very simple. Just enter the name of the link and select the file to be used for the link. Go for creating the link on the Start Menu, Start->Program, or Desktop.

References

  1. MSDN: www.msdn.com
  2. Windows Shell Programming by Scott Seely

More by Author

Get the Free Newsletter!

Subscribe to Developer Insider for top news, trends & analysis

Must Read