/* * Copyright (c) 1983-2013 Martin Atkins, Richard Dobson and Composers Desktop Project Ltd * http://people.bath.ac.uk/masrwd * http://www.composersdesktop.com * This file is part of the CDP System. The CDP System is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. The CDP System is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with the CDP System; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA * */ /*********************************************************** How to Obtain Filename and Path from a Shell Link or Shortcut Last reviewed: July 19, 1996 Article ID: Q130698 The information in this article applies to: * Microsoft Win32 Software Development Kit (SDK), versions 3.51 and 4.0 SUMMARY The shortcuts used in Microsoft Windows 95 provide applications and users a way to create shortcuts or links to objects in the shell's namespace. The IShellLink OLE Interface can be used to obtain the path and filename from the shortcut, among other things. MORE INFORMATION A shortcut allows the user or an application to access an object from anywhere in the namespace. Shortcuts to objects are stored as binary files. These files contain information such as the path to the object, working directory, the path of the icon used to display the object, the description string, and so on. Given a shortcut, applications can use the IShellLink interface and its functions to obtain all the pertinent information about that object. The IShellLink interface supports functions such as GetPath(), GetDescription(), Resolve(), GetWorkingDirectory(), and so on. Sample Code The following code shows how to obtain the filename or path and description of a given link file: ************************************************/ #include #include #include #include #include #include "alias.h" //RWD: for wrapper funcs /********* CONTENTS OF ALIAS.H : int COMinit(void); void COMclose(void); int getAliasInfo(const char *linkfilename, char *path, char *desc); int fileExists(const char *name); *********** END OF CONTENTS OF ALIAS.H ************/ static void ErrorMessage(LPCTSTR str, HRESULT hr); /* RWD: for encapsulation, this should be declared static * GetLinkInfo() fills the filename and path buffer * with relevant information. * hWnd - calling application's window handle. * * lpszLinkName - name of the link file passed into the function. * * lpszPath - the buffer that receives the file's path name. * * lpszDescription - the buffer that receives the file's * description. */ HRESULT GetLinkInfo( HWND hWnd, LPCTSTR lpszLinkName, LPSTR lpszPath, LPSTR lpszDescription) { HRESULT hres; IShellLink *pShLink; WIN32_FIND_DATA wfd; /* Initialize the return parameters to null strings.*/ *lpszPath = '\0'; *lpszDescription = '\0'; /* Call CoCreateInstance to obtain the IShellLink * Interface pointer. This call fails if * CoInitialize is not called, so it is assumed that * CoInitialize has been called. */ hres = CoCreateInstance( &CLSID_ShellLink, NULL, CLSCTX_INPROC_SERVER, &IID_IShellLink, (LPVOID *)&pShLink ); if (SUCCEEDED(hres)) { IPersistFile *ppf; /* The IShellLink Interface supports the IPersistFile * interface. Get an interface pointer to it. */ hres = pShLink->lpVtbl->QueryInterface(pShLink, &IID_IPersistFile, (LPVOID *)&ppf ); if (SUCCEEDED(hres)) { WORD wsz[MAX_PATH]; /* Convert the given link name string to a wide character string. */ MultiByteToWideChar( CP_ACP, 0, lpszLinkName, -1, wsz, MAX_PATH ); /* Load the file. */ hres = ppf->lpVtbl->Load(ppf, wsz, STGM_READ ); if (SUCCEEDED(hres)) { /* Resolve the link by calling the Resolve() interface function. * This enables us to find the file the link points to even if * it has been moved or renamed. */ hres = pShLink->lpVtbl->Resolve(pShLink, hWnd, SLR_ANY_MATCH | SLR_NO_UI); if (SUCCEEDED(hres)) { /* Get the path of the file the link points to. */ hres = pShLink->lpVtbl->GetPath( pShLink, lpszPath, MAX_PATH, &wfd, SLGP_SHORTPATH ); /* Only get the description if we successfully got the path * (We can't return immediately because we need to release ppf & * pShLink.) */ if(SUCCEEDED(hres)) { /* Get the description of the link. ** RWD: probably empty most times! */ hres = pShLink->lpVtbl->GetDescription(pShLink, lpszDescription, MAX_PATH ); } } } ppf->lpVtbl->Release(ppf); } pShLink->lpVtbl->Release(pShLink); } else ErrorMessage("Failure: CoCreateInstance",hres); /*RWD: eg of error message usage*/ return hres; } /********* RWD utility functions *********/ int COMinit(void) { HRESULT res = CoInitialize(NULL); if(res==S_OK) return 1; else return 0; } void COMclose(void) { CoUninitialize(); } int fileExists(const char *name) { struct _finddata_t file; long hFile; hFile = _findfirst((char *)name,&file); return (int)(hFile != -1L); } /*the wrapper function itself, for a console application (no window handle) */ /*requires COM to be initialized*/ int getAliasInfo(const char *linkfilename, char *path, char *desc) { HRESULT res; res = GetLinkInfo(NULL, (LPCTSTR) linkfilename, (LPSTR) path, (LPSTR) desc); return (int) SUCCEEDED(res); } /*from Inside COM: DaleRogerson, changed from C++ to plain C*/ void ErrorMessage(LPCTSTR str, HRESULT hr) { void *pMsgBuf; FormatMessage(FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM, NULL,hr,MAKELANGID(LANG_NEUTRAL,SUBLANG_DEFAULT), (LPTSTR) &pMsgBuf, 0, NULL); printf("\n%s\n%s\n",str,(const char *)pMsgBuf); LocalFree(pMsgBuf); }