VC 为程序创建快捷方式的详细讲解

有时候，为了方便用户使用我们编写的程序，需要在桌面，快速启动或程序组中创建程序的快捷方式。下面就介绍在VC下如何为程序创建快捷方式。

一．得到桌面，快速启动或程序组的路径

这里介绍二个win32 API函数来完成这个任务。

第一个函数 获得系统特殊路径

HRESULT SHGetSpecialFolderLocation(

HWND hwndOwner,  int nFolder, PIDLIST_ABSOLUTE *ppidl

);

第一个参数表示所有者窗口句柄，一般传入NULL就可以了。

第二个参数要示是一个整数id，决定哪个目录是待查找目录,它的取值可能是

　　CSIDL_BITBUCKET            回收站

　　CSIDL_CONTROLS            控制面板

　　CSIDL_DESKTOP              Windows桌面desktop;

　　CSIDL_DESKTOPDIRECTORY   desktop的目录；

　　CSIDL_DRIVES                我的电脑

　　CSIDL_FONTS                 字体目录

　　CSIDL_NETHOOD             网上邻居

　　CSIDL_NETWORK             网上邻居virtual folder

　　CSIDL_PERSONAL             我的文档

　　CSIDL_PRINTERS              打印机

　　CSIDL_PROGRAMS             程序组

　　CSIDL_RECENT                最近打开文档

　　CSIDL_SENDTO                发送到菜单项

　　CSIDL_STARTMENU            快速启动菜单

　　CSIDL_STARTUP               启动目录

　　CSIDL_TEMPLATES            临时文档

第三个参数表示一个条目标识符列表指针，可以传入一个LPITEMIDLIST类型变量，再从这个变量中得到表示路径的字符串。使用完后，要用void CoTaskMemFree(void * pv)来释放资源。

 

第二个函数 将一个条目标识符列表转换为一个文件系统路径

BOOL SHGetPathFromIDList( 

PCIDLIST_ABSOLUTE pidl,  LPTSTR pszPath

);

第一个参数 pidl就是用第一个函数所得到的条目标识符列表指针。

第二个参数pszPath返回表示路径的字符串。

 

这二个函数的头文件均为<shlobj.h>并要引入shell32.lib。

下面给出了一个程序，用来列举你电脑上一些系统特殊路径：

[cpp]  view plain copy

1. #include <stdio.h>  
2. #include <windows.h>  
3. #include <shlobj.h>  
4. #pragma comment(lib, "shell32.lib")  
5.   
6. int main()  
7. {  
8.     const int ENDNUMBER = -1;//哨兵，在遍历数组时遇到此数表示已经到达了数组的最后。  
9.     //设置这个后，你可以在nFolders数组中任意添加删除数据而不用在遍历数组时考虑其中有多少个数据。  
10.   
11.     CoInitialize(NULL);  
12.     int nFolders[] = {  
13.         CSIDL_BITBUCKET, CSIDL_CONTROLS, CSIDL_DESKTOP, CSIDL_DESKTOPDIRECTORY,   
14.         CSIDL_DRIVES, CSIDL_FONTS, CSIDL_NETHOOD, CSIDL_NETWORK, CSIDL_PERSONAL,   
15.         CSIDL_PRINTERS, CSIDL_PROGRAMS, CSIDL_RECENT, CSIDL_SENDTO, CSIDL_STARTMENU,   
16.         CSIDL_STARTUP, CSIDL_TEMPLATES, ENDNUMBER  
17.     };  
18.   
19.     HRESULT       hr;  
20.     LPITEMIDLIST  ppidl;   
21.     char          szPath[MAX_PATH];  
22.   
23.     int i = 0;    
24.     while (nFolders[i] != ENDNUMBER)  
25.     {  
26.         hr = SHGetSpecialFolderLocation(NULL, nFolders[i], &ppidl);   
27.         if (hr != S_OK)  
28.         {  
29.             printf("SHGetSpecialFolderLocation Error\n");  
30.         }  
31.         else  
32.         {  
33.             if (SHGetPathFromIDList(ppidl, szPath))  
34.                 printf("%s\n", szPath);  
35.             else  
36.                 printf("SHGetPathFromIDList Error\n");  
37.             CoTaskMemFree(ppidl);  
38.         }  
39.   
40.         i++;  
41.     }  
42.     CoUninitialize();  
43.     return 0;  
44. }  

由于系统的差异，有时会输出“SHGetPathFromIDList Error”，在我电脑上就输出了5次。有了这个例子，相信不难写出得到桌面桌面（CSIDL_DESKTOP），快速启动（CSIDL_APPDATA），程序组（CSIDL_PROGRAMS）的路径函数。

不过要稍稍注意下快捷启动，要再加上"\\Microsoft\\Internet Explorer\\Quick Launch"。

 

二．创建快捷方式文件

完成第一步的任务后接下来的问题是如何创建快捷方式文件即.lnk文件。首先要了解快捷方式文件要设置什么，然后了了解怎样设置。

2.1快捷方式文件有哪些要设置的内容

下面给出了Spy++和Kmplayer Plus二个程序的快捷方式。

快捷方式必须设置目标，起始位置，快捷键，备注都可以选择性的设置，运行方式一般取默认值----常规窗口。

 

2.2如何设置快捷方式文件的内容

这要用到二个COM接口IShellLink和IPersistFile。由于篇幅问题，这里只讲解二个接口的部分函数。

IShellLink的部分函数

HRESULT SetPath(LPCTSTR pszFile);             设置目标

HRESULT SetWorkingDirectory(LPCTSTR pszDir);  设置起始位置

HRESULT SetHotkey(WORD wHotkey);           设置快捷键

HRESULT SetShowCmd(int iShowCmd);           设置运行方式

       有三种选择SW_SHOWNORMAL常规窗口

SW_SHOWMAXIMIZED最大化SW_SHOWMINNOACTIVE最小化

HRESULT SetDescription(LPCTSTR pszName);      设置备注

要特别说下SetHotkey()中的参数WORD wHotkey。MSDN上对其的解释为：

The address of the hot key. 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

意思就是对这个WORD值，低位上是virtual key code，高位上可以是ALT,CTRL等组合键。可以用MAKEWORD(low, high)来生成一个WORD，如Ctrl+F12可以用MAKEWORD(VK_F12, HOTKEYF_CONTROL)表示。

 

IPersistFile的部分函数

HRESULT Save(          保存快捷方式

  LPCOLESTR pszFileName, BOOL fRemember

);

第一个参数是要保存文件的文件名，要求是绝对路径。

第二个参数涉及COM的持续性问题（注1），一般传入TRUE即可。

 

要创建COM对象可以用CoCreateInstance()函数（见注2）和QueryInterface()函数（见注3）。下面给出了创建的代码：

IShellLink     *pLink;   //IShellLink对象指针

IPersistFile    *ppf;      //IPersisFil对象指针

创建IShellLink实例

CoCreateInstance(CLSID_ShellLink,NULL,CLSCTX_INPROC_SERVER,IID_IShellLink,(void**)&pLink);

从IShellLink对象中获取IPersistFile接口

pLink->QueryInterface(IID_IPersistFile, (void**)&ppf);

创建之后就可以对pLink设置目标，快捷键，备注等，设置完后再用ppf创建快捷方式文件就可以了。当然最后要记得释放资源，pLink->Release(); ppf->Release()。

 

三．已封装好的函数代码

下面给出封装好的函数代码，可以在程序中直接使用（在XP+VC6.0下测试过）。

[cpp]  view plain copy

1. //得到当前桌面路径  
2. BOOL GetDesktopPath(char *pszDesktopPath)  
3. {  
4.     LPITEMIDLIST  ppidl = NULL;   
5.       
6.     if (SHGetSpecialFolderLocation(NULL, CSIDL_DESKTOP, &ppidl) == S_OK)  
7.     {  
8.         BOOL flag = SHGetPathFromIDList(ppidl, pszDesktopPath);  
9.         CoTaskMemFree(ppidl);  
10.         return flag;  
11.     }  
12.   
13.     return FALSE;  
14. }     
15. //得到快速启动栏的路径  
16. BOOL GetIEQuickLaunchPath(char *pszIEQueickLaunchPath)  
17. {     
18.     LPITEMIDLIST  ppidl;              
19.       
20.     if (SHGetSpecialFolderLocation(NULL, CSIDL_APPDATA, &ppidl) == S_OK)  
21.     {  
22.         BOOL flag = SHGetPathFromIDList(ppidl, pszIEQueickLaunchPath);  
23.         strcat(pszIEQueickLaunchPath, "\\Microsoft\\Internet Explorer\\Quick Launch");  
24.         CoTaskMemFree(ppidl);  
25.         return flag;  
26.     }  
27.   
28.     return FALSE;  
29. }  
30. //得到 开始->程序组 的路径  
31. BOOL GetProgramsPath(char *pszProgramsPath)  
32. {  
33.     LPITEMIDLIST  ppidl;   
34.       
35.     if (SHGetSpecialFolderLocation(NULL, CSIDL_PROGRAMS, &ppidl) == S_OK)  
36.     {  
37.         BOOL flag = SHGetPathFromIDList(ppidl, pszProgramsPath);  
38.         CoTaskMemFree(ppidl);  
39.         return flag;  
40.     }  
41.   
42.     return FALSE;  
43. }  
44. /* 
45. 函数功能：对指定文件在指定的目录下创建其快捷方式 
46. 函数参数： 
47. lpszFileName    指定文件，为NULL表示当前进程的EXE文件。 
48. lpszLnkFileDir  指定目录，不能为NULL。 
49. lpszLnkFileName 快捷方式名称，为NULL表示EXE文件名。 
50. wHotkey         为0表示不设置快捷键 
51. pszDescription  备注 
52. iShowCmd        运行方式，默认为常规窗口 
53. */  
54. BOOL CreateFileShortcut(LPCSTR lpszFileName, LPCSTR lpszLnkFileDir, LPCSTR lpszLnkFileName, LPCSTR lpszWorkDir, WORD wHotkey, LPCTSTR lpszDescription, int iShowCmd = SW_SHOWNORMAL)  
55. {  
56.     if (lpszLnkFileDir == NULL)  
57.         return FALSE;  
58.   
59.     HRESULT hr;  
60.     IShellLink     *pLink;  //IShellLink对象指针  
61.     IPersistFile   *ppf; //IPersisFil对象指针  
62.       
63.     //创建IShellLink对象  
64.     hr = CoCreateInstance(CLSID_ShellLink, NULL, CLSCTX_INPROC_SERVER, IID_IShellLink, (void**)&pLink);  
65.     if (FAILED(hr))  
66.         return FALSE;  
67.       
68.     //从IShellLink对象中获取IPersistFile接口  
69.     hr = pLink->QueryInterface(IID_IPersistFile, (void**)&ppf);  
70.     if (FAILED(hr))  
71.     {  
72.         pLink->Release();  
73.         return FALSE;  
74.     }  
75.       
76.     //目标  
77.     if (lpszFileName == NULL)  
78.         pLink->SetPath(_pgmptr);  
79.     else  
80.         pLink->SetPath(lpszFileName);  
81.       
82.     //工作目录  
83.     if (lpszWorkDir != NULL)  
84.         pLink->SetPath(lpszWorkDir);  
85.       
86.     //快捷键  
87.     if (wHotkey != 0)  
88.         pLink->SetHotkey(wHotkey);  
89.       
90.     //备注  
91.     if (lpszDescription != NULL)  
92.         pLink->SetDescription(lpszDescription);  
93.       
94.     //显示方式  
95.     pLink->SetShowCmd(iShowCmd);  
96.   
97.   
98.     //快捷方式的路径 + 名称  
99.     char szBuffer[MAX_PATH];  
100.     if (lpszLnkFileName != NULL) //指定了快捷方式的名称  
101.         sprintf(szBuffer, "%s\\%s", lpszLnkFileDir, lpszLnkFileName);  
102.     else     
103.     {  
104.         //没有指定名称，就从取指定文件的文件名作为快捷方式名称。  
105.         char *pstr;  
106.         if (lpszFileName != NULL)  
107.             pstr = strrchr(lpszFileName, '\\');  
108.         else  
109.             pstr = strrchr(_pgmptr, '\\');  
110.   
111.         if (pstr == NULL)  
112.         {     
113.             ppf->Release();  
114.             pLink->Release();  
115.             return FALSE;  
116.         }  
117.         //注意后缀名要从.exe改为.lnk  
118.         sprintf(szBuffer, "%s\\%s", lpszLnkFileDir, pstr);  
119.         int nLen = strlen(szBuffer);  
120.         szBuffer[nLen - 3] = 'l';  
121.         szBuffer[nLen - 2] = 'n';  
122.         szBuffer[nLen - 1] = 'k';  
123.     }  
124.     //保存快捷方式到指定目录下  
125.     WCHAR  wsz[MAX_PATH];  //定义Unicode字符串  
126.     MultiByteToWideChar(CP_ACP, 0, szBuffer, -1, wsz, MAX_PATH);  
127.       
128.     hr = ppf->Save(wsz, TRUE);  
129.       
130.     ppf->Release();  
131.     pLink->Release();  
132.     return SUCCEEDED(hr);  
133. }  

调用如下例：

[cpp]  view plain copy

1. int main()  
2. {  
3.     char  szPath[MAX_PATH];  
4.     CoInitialize(NULL);  
5.   
6.     GetDesktopPath(szPath);  
7.     if (CreateFileShortcut(NULL, szPath, NULL, NULL, MAKEWORD(VK_F12, HOTKEYF_CONTROL), "That is a test"))  
8.         printf("创建成功\n");  
9.   
10.     CoUninitialize();  
11.     return 0;  
12. }  

头文件及引用库：

#include <stdio.h>

#include <windows.h>

#include <shlobj.h>

#pragma comment(lib, "shell32.lib")

效果如图：

有兴趣的话，可以将代码进一步的整理。

 

 

注1          参见http://www.vckbase.com/document/viewdoc/?id=1546

注2          参见http://baike.baidu.com/view/1141927.htm

注3          参见http://baike.baidu.com/view/5395542.htm