CShellLink & CUrlShellLink v1.1

Download source files - 12 Kb

Introduction

Welcome to CShellLink and CUrlShellLink, 2 freeware MFC wrapper classes to encapsulate shell shortcuts.

Features

Usage

History

API Reference

Contacting the Author

Features

• Simple and clean C++ interface.
• Uses standard MFC classes in the interface.
• Simple console app is provided which tests all of the class methods.

Usage

• To use the class in your code simple include ShellLink.cpp in your project and #include ShellLink.h in which ever of your modules needs to make calls to the classes.
• To see the classes in action, have a look at the code in main() in the module main.cpp.
• Your code will need to include MFC either statically or dynamically.

History

v1.0 (10 December 1998)

• Initial public release.

V1.1 (12th December 1998)

• Updated sample program to be called ShelLink.
• Fixed a bug in CUrlShellLink::Save() where m_sTarget was not being set.
• Updated the trace comments in the code to include the function from which the function fails.
• Demo program now displays some info about what it is doing to the console window.
• Default build configuration is now ASCII Debug instead of Unicode Debug.

API Reference

The API consists of the following:

CShellLinkInfo::m_sTarget
CShellLinkInfo::m_pidl
CShellLinkInfo::m_sArguments
CShellLinkInfo::m_sDescription
CShellLinkInfo::m_wHotkey
CShellLinkInfo::m_sIconLocation
CShellLinkInfo::m_nIconIndex
CShellLinkInfo::m_nShowCmd
CShellLinkInfo::m_sWorkingDirectory
CShellLink::Create
CShellLink::Load
CShellLink::Save
CShellLink::Resolve
CUrlShellLink::Create
CUrlShellLink::Load
CUrlShellLink::Save
CUrlShellLink::Invoke

Notes:

• The CShellLink class also includes simple Set and Get functions which modify the CShellLinkInfo data which the class contains.
• Since CUrlShellLink is derived from CShellLink, you can call all of the standard Get and Set functions which it inherits from CShellLink.

CShellLinkInfo::m_sTarget

Remarks:
This value stores the target of the shortcut. In the case of an ordinary shortcut, this will normally point to an executable or a document. In the case of an internet shortcut this will be a URL. m_sTarget is of type CString.

CShellLinkInfo::m_pidl

Remarks:
Contains a pointer to the item identifier for the shortcut. m_pidl is of type LPITEMIDLIST. This value is not valid In the case of an internet shortcut.

CShellLinkInfo::m_sArguments

Remarks:
Contains the command line arguments which are passed to the target when invoking the shortcut. This value is not valid In the case of an internet shortcut. m_sArguments is of type CString.

CShellLinkInfo::m_sDescription

Remarks:
Contains the description for the shortcut. m_sDescription is of type CString.

CShellLinkInfo::m_wHotkey

Remarks:
Contains the hotkey associated with the shortcut. m_wHotkey is of type WORD. The virtual-key code is in the low-order byte, and the modifier flags are in the high-order byte. The modifier flags can be a combination of the following values:

HOTKEYF_ALT	ALT key
HOTKEYF_CONTROL	CTRL key
HOTKEYF_EXT	Extended key
HOTKEYF_SHIFT	SHIFT key

CShellLinkInfo::m_sIconLocation

Remarks:
Contains the filename where the icon for the shortcut is located. m_sIconLocation is of type CString.

CShellLinkInfo::m_nIconIndex

Remarks:
Contains the index in m_sIconLocation of the icon for the shortcut. m_sIconLocation is of type int.

CShellLinkInfo::m_nShowCmd

Remarks:
Contains the show command which is used when invoking the shortcut. m_nShowCmd is of type int. For a list of the show commands, see the description of the ShowWindow() function in books online.

CShellLinkInfo::m_sWorkingDirectory

Remarks:
Contains the working directory which the shortcut will use when invoked. m_sWorkingDirectory is of type CString.

CShellLink::Create

BOOL CShellLink::Create(const CShellLinkInfo& sli);

Return Value:
If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE.

Parameters:

• sli -- The structure which contains all the parameters to use in the shortcut. They will be updated on disk following a call to CShellLink::Save().

Remarks:
Call this member function to initialise the shortcut with initial values.

CShellLink::Load

BOOL CShellLink::Load(const CString& sFilename);

Return Value:
If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE.

Parameters:

• sFilename -- The filename from which to load the shortcut information. Normally this will have the extension ".lnk".

Remarks:
Call this member function to load up a shortcut from disk.

CShellLink::Save

BOOL CShellLink::Save(const CString& sFilename);

Return Value:
If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE.

Parameters:

• sFilename -- The filename to save this shortcut to. Normally this will have the extension ".lnk".

Remarks:
Call this member function to save a shortcut to disk. Prior to calling this function you would normally call CShellLink::Create() method.

CShellLink::Resolve

BOOL CShellLink::Resolve(CWnd* pParentWnd, DWORD dwFlags);

Return Value:
If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE.

Parameters:

• pParentWnd -- The parent window of a window that the shell uses as the parent window for a dialog box. The shell displays the dialog box if it needs to prompt the user for more information while resolving a shell link.
• fFlags -- Action flags. This parameter can be a combination of the following values:

  SLR_ANY_MATCH	Resolves the link, displaying a dialog box if the system needs information from the user.
  SLR_NO_UI	Prevents the shell from displaying a dialog box if it cannot resolve the shell link. When this flag is specified, the high-order word of fFlags specifies a timeout duration, in milliseconds. The function returns if the link cannot be resolved within the timeout duration. If the high-order word is set to zero, the timeout duration defaults to 3000 milliseconds (3 seconds).
  SLR_UPDATE	Directs the shell to update the path to the link and the list of identifiers if the link object has been changed. If this value is used, it is not necessary to call the IPersistFile::IsDirty() method to determine whether the link object has changed.

Remarks:
Call this member function to ensure that a shortcut is pointing to valid data. This is known as "resolving" a shortcut. For those who frequently move files from volume to volume, the Searching for Shortcut dialog should be familiar.

CUrlShellLink::Create

BOOL CUrlShellLink::Create(const CShellLinkInfo& sli);

Return Value:
If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE.

Parameters:

• sli -- The structure which contains all the parameters to use in the shortcut. They will be updated on disk following a call to CUrlShellLink::Save().

Remarks:
Call this member function to initialise the shortcut with initial values.

CUrlShellLink::Load

BOOL CUrlShellLink::Load(const CString& sFilename);

Return Value:
If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE.

Parameters:

• sFilename -- The filename from which to load the shortcut information. Normally this will have the extension ".url".

Remarks:
Call this member function to load up a shortcut from disk.

CUrlShellLink::Save

BOOL CUrlShellLink::Save(const CString& sFilename);

Return Value:
If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE.

Parameters:

• sFilename -- The filename to save this shortcut to. Normally this will have the extension ".url".

Remarks:
Call this member function to save a shortcut to disk. Priot to calling this function you would normally call the CUrlShellLink::Create() method.

CUrlShellLink::Invoke

BOOL CUrlShellLink::Invoke(CWnd* pParentWnd, DWORD dwFlags, const CString& sVerb);

Return Value:
If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE.

Parameters:

• pParentWnd -- Handle to the parent window. If dwFlags is set to IURL_INVOKECOMMAND_FL_USE_DEFAULT_VERB, this member is ignored.
• dwFlags -- Flag value that specifies how the IUniformResourceLocator::InvokeCommand() method will execute. This value can be a combination of the following:

  IURL_INVOKECOMMAND_FL_ALLOW_UI	Interaction with the user is allowed and the pParentWnd parameter is valid. If this is not set, interaction with the user is not allowed and the pParentWnd member is ignored.
  IURL_INVOKECOMMAND_FL_USE_DEFAULT_VERB	Default verb for the Internet Shortcut's protocol is to be used and the sVerb parameter is ignored. If this bit is not set, the verb is specified by sVerb.

• sVerb -- string that contains the verb to be invoked by IUniformResourceLocator::InvokeCommand(). If dwFlags is set to IURL_INVOKECOMMAND_FL_USE_DEFAULT_VERB, this parameter is ignored.

Remarks:
Call this member function to perform an action on a URL. The most common action would be to open it, which will open it up in your default web browser. You could also use the "edit" verb assuming you had a HTML editor open.

Contacting the Author

PJ Naughter
Email: pjn@indigo.ie
Web: http://www.naughter.com
12th December 1998

You must Sign In to use this message board.

FAQ    Noise Tolerance Very HighHighMediumLowVery Low   Layout Expand Posts & RepliesThread ViewNo JavascriptNo JS + Preview   Per page 102550

Msgs 1 to 17 of 17 (Total in Forum: 17) (Refresh) FirstPrevNext

Modifying target boxmonkey 11:57 30 Aug '06   Modifying the shell link target of an existing shortcut by loading the shortcut, calling SetPath and saving the target did not work because of this section of code in Save(): //Set the various link values if (m_sli.m_pidl) { hRes = m_psl->SetIDList(m_sli.m_pidl); if (!SUCCEEDED(hRes)) TRACE(_T("CShellLink::Save, Failed in call to IShellLink::SetIDList, HRESULT was %x\n"), hRes); } else { hRes = m_psl->SetPath(m_sli.m_sTarget); if (!SUCCEEDED(hRes)) TRACE(_T("CShellLink::Save, Failed in call to IShellLink::SetPath, HRESULT was %x\n"), hRes); } Which I modified to: //Set the various link values if (m_sli.m_pidl) { hRes = m_psl->SetIDList(m_sli.m_pidl); if (!SUCCEEDED(hRes)) TRACE(_T("CShellLink::Save, Failed in call to IShellLink::SetIDList, HRESULT was %x\n"), hRes); } // else //{ hRes = m_psl->SetPath(m_sli.m_sTarget); if (!SUCCEEDED(hRes)) TRACE(_T("CShellLink::Save, Failed in call to IShellLink::SetPath, HRESULT was %x\n"), hRes); //} Now seems to work as expected. Sign In·View Thread·PermaLink Create a shortcut to a dial-up connection on the desktop Ruk007 20:29 7 Jul '05   I want to create a shortcut to a dial-up connection on the desktop using VB code.. even some other language it doesn't matter.. neet art.. Sign In·View Thread·PermaLink 1.00/5 (1 vote) Small Mistake Bin 15:06 25 Jan '03   In your code: CString CShellLink::GetArguments() const { return m_sli.m_sTarget; } Should it return m_sli.m_sArguments? Other than that, excellent article. Sign In·View Thread·PermaLink Re: Small Mistake pjnaughter 3:46 26 Jan '03   Just to let you know that I have updated the release on my web site (www.naughter.com) to address this problem. Sign In·View Thread·PermaLink How to create a shortcut to a CPl(Control Panel) applet? Anonymous 16:32 5 Aug '02   Thank you! Sign In·View Thread·PermaLink Re: How to create a shortcut to a CPl(Control Panel) applet? pjnaughter 6:49 6 Aug '02   Create one yourself, then examine the shortcut (lnk file) using say any text editor to examine it's contents. From memory I think the target is something like "{GUID of Control Panel}". Sign In·View Thread·PermaLink What about shourcut to DUN? Paras Shah 20:22 31 May '02   Hi there, Is there any way out to create the shortcut to the DUN on the desktop? If there then do let me know. Thanx, Paras Sign In·View Thread·PermaLink Re: What about shourcut to DUN? pjnaughter 6:50 6 Aug '02   See my previous reply on creating a shortcut to a control panel applet. Sign In·View Thread·PermaLink m_nShowCmd not working win2K Anonymous 15:07 6 Mar '02   I cannot seem to get the m_nShowCmd to work. I assign set it to SW_MINIMIZE and it creates the .lnk file okay. Only the show is normal when looking at the properties. -Thanks, Mike Sign In·View Thread·PermaLink 3.00/5 (1 vote) Re: m_nShowCmd not working win2K Mike Loungo 15:59 6 Mar '02   Okay, just for those who don't know. I found that SW_SHOWMINNOACTIVE is required for m_nShowCmd when you want the program to be minimized. You would think that since SW_MAXIMIZE is for maximized then SW_MINIMIZE would be for minimized. Nope, use SW_SHOWMINNOACTIVE or value of 7 Thanks, Mike Sign In·View Thread·PermaLink bug in urllink stewe 4:36 19 Oct '01   original code: //Set the various arguments HRESULT hRes = m_psl->SetWorkingDirectory(m_sli.m_sTarget); if (!SUCCEEDED(hRes)) TRACE(_T("CUrlShellLink::Save, Failed in call to IShellLink::SetPath, HRESULT was %x\n"), hRes); fixed one: //Set the various arguments HRESULT hRes = m_psl->SetPath(m_sli.m_sTarget); if (!SUCCEEDED(hRes)) TRACE(_T("CUrlShellLink::Save, Failed in call to IShellLink::SetPath, HRESULT was %x\n"), hRes); just the name. Stewe Stewe Sign In·View Thread·PermaLink 2.00/5 (1 vote) Re: bug in urllink pjnaughter 3:52 26 Jan '03   The latest version on my web site (www.naughter.com) does not have this problem. Regards, Sign In·View Thread·PermaLink I think Win2k problem... stewe 3:31 19 Oct '01   CShellLink::Initialise, Failed in call to CoCreateInstance for IShellLink, HRESULT was 80004002 Stewe Sign In·View Thread·PermaLink Re: I think Win2k problem... pjnaughter 3:47 26 Jan '03   Did you initialize COM in your app! Sign In·View Thread·PermaLink I cannot get it to work... Andreas Philipson 22:11 1 Aug '01   Hi, Everytime I try to load up a shortcut the Load () function just returns false - I've tried the app on both win9x and win2k and it doesn't work on any one. These shortcuts were created using the system and not this class. CShellLink shell_link; shell_link.Load ("C:\\t.lnk"); traces CShellLink::Initialise, Failed in call to CoCreateInstance for IShellLink, HRESULT was 800401f0 Andreas Philipson Sign In·View Thread·PermaLink 4.00/5 (1 vote) Never mind... Andreas Philipson 0:47 2 Aug '01   I solved it... The CoInitialize () was never called . Andreas Philipson Sign In·View Thread·PermaLink CShellLink::sethotkey problem d2724 23:14 29 Oct '00   In am checking the functionality of ur class. i am facing problems in using the method sethotkey. i modified the code(using CShellLink part) in main.cpp as follows for my requirement: /*** modefied code starts ***************/ char str[256], str1[256]; LPITEMIDLIST pidl; SHGetSpecialFolderLocation(0, CSIDL_DESKTOP, &pidl); SHGetPathFromIDList(pidl, str); SHGetPathFromIDList(pidl, str1); lstrcat(str,"\\notepad.exe"); lstrcat(str1,"\\notepad.lnk"); //Test all the functionality of the classes //First Saving CShellLinkInfo sli1; sli1.m_sTarget = /*_T("notepad.exe")*/str; // sli1.m_sArguments = _T("c:\\config.sys"); // sli1.m_sWorkingDirectory = _T("c:\\"); sli1.m_wHotkey = 0x641; // ctrl_a sli1.m_sDescription = _T("Edit your untitled"); sli1.m_sIconLocation = _T("shell32.dll"); sli1.m_nIconIndex = 21; //Use an interesting icon sli1.m_nShowCmd = SW_MAXIMIZE; CShellLink sl1; if (sl1.Create(sli1)) { if (!sl1.Save(/*_T("c:\\Edit your untitled.lnk")*/str1)) TRACE(_T("Failed to save link\n")); else _tprintf(_T("A shortcut to edit your untitled had been created on you C:\\ drive\n")); } else TRACE(_T("Failed to create link\n")); _tprintf(_T("Till Next time!!!, Press any key to exit\n")); ch = getch(); sli1.m_sTarget = /*_T("notepad.exe")*/str; // sli1.m_sArguments = _T("c:\\config.sys"); // sli1.m_sWorkingDirectory = _T("c:\\"); sli1.m_wHotkey = 0x642; // ctrl_b sli1.m_sDescription = _T("Edit your untitled"); sli1.m_sIconLocation = _T("shell32.dll"); sli1.m_nIconIndex = 21; //Use an interesting icon sli1.m_nShowCmd = SW_MAXIMIZE; // CShellLink sl1; if (sl1.Create(sli1)) { if (!sl1.Save(/*_T("c:\\Edit your untitled.lnk")*/str1)) TRACE(_T("Failed to save link\n")); else _tprintf(_T("A shortcut to edit your untitled had been created on you C:\\ drive\n")); } else TRACE(_T("Failed to create link\n")); /*** modefied code ends ***************/ Basically in this code .... first, i create a shortcut to notepad.exe and also assign a hotkey(here ctrl+a) to invoke the target. next wait for user to press any key.... second, i agian create the shortcut to notepad.exe and also assign a different hotkey(here ctrl+b) to invoke the target. ..... so after first step if i press ctrl+a it invokes the target. now after second step if i press ctrl+b it invokes the target. fine. now if i press crtl+a (which actaully i chagned to ctrl+b) it invokes the target-->Problem. i want to modify the hotkey of the shorcut in the above source code... when i modify, only the new hotkey should invoke the target. and the old hotkey can be reassinged to someother shorcuts.. how can i do that???????? any suggestions...???? Sign In·View Thread·PermaLink 3.50/5 (2 votes)

Last Visit: 21:58 20 Mar '10     Last Update: 21:58 20 Mar '10 1