SHELLEXECUTEINFO 和 ShellExecuteEx的使用

最新推荐文章于 2023-05-11 09:02:09 发布

转载最新推荐文章于 2023-05-11 09:02:09 发布 · 1.7k 阅读

文章标签：

#null #文档 #shell #扩展 #存储 #file

本文介绍如何使用SHELLEXECUTEINFO结构与ShellExecuteEx函数来执行各种操作，如打开应用程序、文档、网页，发送电子邮件，打印文档，查找文件及启动程序直至其运行结束等。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

SHELLEXECUTEINFO 和 ShellExecuteEx的使用

 1      SHELLEXECUTEINFO ShellInfo;
 2              
 3 
 4      memset(&ShellInfo, 0, sizeof(ShellInfo));
 5 
 6      ShellInfo.cbSize = sizeof(ShellInfo);
 7 
 8      ShellInfo.hwnd = NULL;
 9 
10      ShellInfo.lpVerb = _T("open");
11 
12      ShellInfo.lpFile = szFilePath;
13 
14      ShellInfo.nShow = SW_SHOWNORMAL;
15 
16      ShellInfo.fMask = SEE_MASK_NOCLOSEPROCESS;
17  
18 
19      BOOL bResult = ShellExecuteEx(&ShellInfo);

一、SHELLEXECUTEINFO 结构

在MSDN中，它这样定义：

Contains information used by ShellExecuteEx

原型如下：

 1 typedef struct _SHELLEXECUTEINFO{
 2     DWORD cbSize; 
 3     ULONG fMask; 
 4     HWND hwnd; 
 5     LPCTSTR lpVerb; 
 6     LPCTSTR lpFile; 
 7     LPCTSTR lpParameters; 
 8     LPCTSTR lpDirectory; 
 9     int nShow; 
10     HINSTANCE hInstApp; 
11  
12     // Optional members 
13     LPVOID lpIDList; 
14     LPCSTR lpClass; 
15     HKEY hkeyClass; 
16     DWORD dwHotKey; 
17     HANDLE hIcon; 
18     HANDLE hProcess; 
19 } SHELLEXECUTEINFO, FAR *LPSHELLEXECUTEINFO;

参数详解：

cbSize

结构大小，以字节为单位。

fMask

一个标志数组，用来设置其他成员的有效性。

hwnd

可选。执行ShellExecuteEx的窗口句柄，可设为NULL。

lpVerb

指定执行的动作，包括：edit ，explore ，find ，open，print， properties

lpFile

以\0 结尾的字符串，指出 lpVerb 的操作对象的路径，被系统支持的操作包括文本的 open 、 print等

lpParameters

可选。运行/打开程序的参数，如果打开的是一个文档，则该项无效

lpDirectory

可选。指明工作目录的名字，成员没有说明，则默认为当前目录

nShow

必须。指定打开的程序的显示方式，为SW_值中的一个。

hInstApp

【out】如果设置SEE_MASK_NOCLOSEPROCESS S值并且ShellExecuteEx 调用成功，则该项的值大于32，如果调用失败，则将设置为 SE_ERR_XXX 的错误值。

lpIDList

一个ITEMIDLIST结构的地址，用来存储成员的特别标识符，当fMask不包括SEE_MASK_IDLIST或SEE_MASK_INVOKEIDLIST时该项被忽略

lpClass

用以指明文件类别的名字或GUID，当fMask不包括SEE_MASK_CLASSNAME时该项被忽略

hkeyClass

获得已在系统注册的文件类型的Handle，当fMask不包括SEE_MASK_HOTKEY时该项被忽略

dwHotKey

程序的热键关联，低位存储虚拟关键码（Key Code），高位存储修改标志位(HOTKEYF_)，修改标志为（modifier flags）的详细列表请看WM_SETHOTKEY消息的描述，当fmask不包括SEE_MASK_HOTKEY时该项被忽略

DUMMYUNIONNAME

hIcon

取得对应文件类型的图标的Handle，当fMask不包括SEE_MASK_ICON时该项被忽略

hMonitor

将文档显示在显示器上的Handle，当fMask不包括SEE_MASK_HMONITOR时该项被忽略

hProcess

指向新启动的程序的句柄。若fMask不设为SEE_MASK_NOCLOSEPROCESS则该项值为NULL。但若程序没有启动，即使fMask设为SEE_MASK_NOCLOSEPROCESS，该值也仍为NULL。

二、ShellExecuteEx

功能：Performs an operation on a specified file。对指定应用程序执行某个操作

原型：

BOOL ShellExecuteEx(LPSHELLEXECUTEINFO lpExecInfo);

参数：

lpExecInfo

[in, out] 一个指向 SHELLEXECUTEINFO 结构的指针，用来传递和保存应用程序执行相关的信息。

返回值：

如果函数成功执行就返回TRUE，否则返回 FALSE 。可调用 GetLastError 获取错误信息。

备注：

由于ShellExecuteEx 能够将执行委托给那些由组件对象模型COM激活的Shell 扩展（数据源，上下文菜单句柄，动词实现），因此在调用ShellExecuteEx 之前要先初始化 COM。某些Shell 扩展要求单线程单元模型的COM，在这种情况下，应当像下面一般初始化COM：

CoInitializeEx (NULL,COINIT_APARTMENTTHREADED | COINIT_DISABLE_OLE1DDE)

在某些情况下 ShellExecuteEx 并没有使用这种类型的Shell 扩展，这时就无需初始化COM。虽然如此，总是在使用这个函数之前初始化COM是个不错的举措。

三、例子

1、打开一个应用程序

 1      SHELLEXECUTEINFO ShellInfo;
 2              
 3 
 4      memset(&ShellInfo, 0, sizeof(ShellInfo));
 5 
 6      ShellInfo.cbSize = sizeof(ShellInfo);
 7 
 8      ShellInfo.hwnd = NULL;
 9 
10      ShellInfo.lpVerb = _T("open");
11 
12      ShellInfo.lpFile = szFilePath; // 此处写执行文件的绝对路径
13 
14     ShellInfo.nShow = SW_SHOWNORMAL;
15 
16      ShellInfo.fMask = SEE_MASK_NOCLOSEPROCESS;
17  
18 
19      BOOL bResult = ShellExecuteEx(&ShellInfo);

2、如何打开一个文档

程序代码如上

3、如何打开一个网页

 1      SHELLEXECUTEINFO ShellInfo;
 2              
 3 
 4      memset(&ShellInfo, 0, sizeof(ShellInfo));
 5 
 6      ShellInfo.cbSize = sizeof(ShellInfo);
 7 
 8      ShellInfo.hwnd = NULL;
 9 
10      ShellInfo.lpVerb = _T("open");
11 
12      ShellInfo.lpFile = _T("http://www.sina.com");
13 
14      ShellInfo.nShow = SW_SHOWNORMAL;
15 
16      ShellInfo.fMask = SEE_MASK_NOCLOSEPROCESS;
17  
18 
19      BOOL bResult = ShellExecuteEx(&ShellInfo);

4、如何启动一个程序，直到它运行结束？

 1 SHELLEXECUTEINFO ShellInfo;
 2              
 3 
 4      memset(&ShellInfo, 0, sizeof(ShellInfo));
 5 
 6      ShellInfo.cbSize = sizeof(ShellInfo);
 7 
 8      ShellInfo.hwnd = NULL;
 9 
10      ShellInfo.lpVerb = _T("open");
11 
12      ShellInfo.lpFile = szFilePath;
13 
14      ShellInfo.nShow = SW_SHOWNORMAL;
15 
16      ShellInfo.fMask = SEE_MASK_NOCLOSEPROCESS;
17 
18      ShellExecuteEx(&ShellInfo);
19  
20 
21 WaitForSingleObject(ShellInfo.hProcess,INFINITE);

Q: 如何打开一个应用程序？ShellExecute(this->m_hWnd,"open","calc.exe","","", SW_SHOW );
或
ShellExecute(this->m_hWnd,"open","notepad.exe",
    "c:\MyLog.log","",SW_SHOW );
As you can see, I haven't passed the full path of the programs. 
 
Q: 如何打开一个同系统程序相关连的文档？
ShellExecute(this->m_hWnd,"open",
    "c:\abc.txt","","",SW_SHOW );
 
Q: 如何打开一个网页？
ShellExecute(this->m_hWnd,"open",
    "http://www.google.com","","", SW_SHOW );
 
Q: 如何激活相关程序，发送EMAIL？
ShellExecute(this->m_hWnd,"open",
    "mailto:nishinapp@yahoo.com","","", SW_SHOW );
 
Q: 如何用系统打印机打印文档？
ShellExecute(this->m_hWnd,"print",
    "c:\abc.txt","","", SW_HIDE);
 
Q: 如何用系统查找功能来查找指定文件？
ShellExecute(m_hWnd,"find","d:\nish",
    NULL,NULL,SW_SHOW);
 
Q: 如何启动一个程序，直到它运行结束？
SHELLEXECUTEINFO ShExecInfo = {0};
ShExecInfo.cbSize = sizeof(SHELLEXECUTEINFO);
ShExecInfo.fMask = SEE_MASK_NOCLOSEPROCESS;
ShExecInfo.hwnd = NULL;
ShExecInfo.lpVerb = NULL;
ShExecInfo.lpFile = "c:\MyProgram.exe";             
ShExecInfo.lpParameters = "";     
ShExecInfo.lpDirectory = NULL;
ShExecInfo.nShow = SW_SHOW;
ShExecInfo.hInstApp = NULL;       
ShellExecuteEx(&ShExecInfo);
WaitForSingleObject(ShExecInfo.hProcess,INFINITE);
或：
PROCESS_INFORMATION ProcessInfo; 
STARTUPINFO StartupInfo; //This is an [in] parameter
ZeroMemory(&StartupInfo, sizeof(StartupInfo));
StartupInfo.cb = sizeof StartupInfo ; //Only compulsory field
if(CreateProcess("c:\winnt\notepad.exe", NULL, 
    NULL,NULL,FALSE,0,NULL,
    NULL,&StartupInfo,&ProcessInfo))
{ 
    WaitForSingleObject(ProcessInfo.hProcess,INFINITE);
    CloseHandle(ProcessInfo.hThread);
    CloseHandle(ProcessInfo.hProcess);
}  
else
{
    MessageBox("The process could not be started...");
}
 
 
Q: 如何显示文件或文件夹的属性？
SHELLEXECUTEINFO ShExecInfo ={0};
ShExecInfo.cbSize = sizeof(SHELLEXECUTEINFO); 
ShExecInfo.fMask = SEE_MASK_INVOKEIDLIST ;
ShExecInfo.hwnd = NULL;
ShExecInfo.lpVerb = "properties";
ShExecInfo.lpFile = "c:\"; //can be a file as well
ShExecInfo.lpParameters = ""; 
ShExecInfo.lpDirectory = NULL;
ShExecInfo.nShow = SW_SHOW;
ShExecInfo.hInstApp = NULL; 
ShellExecuteEx(&ShExecInfo);