ShellExecuteEx(转载)

标签:
杂谈 |
分类: C和Cplusplus |
http://blog.csdn.net/kesalin/article/details/4076061#
今天来说说ShellExecuteEx这个函数,先翻译MSDN,然后看个例子。
ShellExecuteEx Function
对指定应用程序执行某个操作
语法:
BOOLShellExecuteEx(
LPSHELLEXECUTEINFO lpExecInfo
);
参数:
lpExecInfo
[in, out]
返回值:
如果函数成功执行就返回TRUE,否则返回
备注:
由于ShellExecuteEx
CoInitializeEx(NULL, COINIT_APARTMENTTHREADED | COINIT_DISABLE_OLE1DDE)
在某些情况下
如果有多个显示器,并且你指定了一个HWND
如果这个函数执行成功,它会设置
提供SE_ERR_XXX
Error |
Description |
ERROR_FILE_NOT_FOUND |
指定文件不存在 |
ERROR_PATH_NOT_FOUND |
指定路径不存在 |
ERROR_DDE_FAIL |
动态数据交换 |
ERROR_NO_ASSOCIATION |
没有与制定文件名扩展对应的应用程序 |
ERROR_ACCESS_DENIED |
访问指定文件被拒绝 |
ERROR_DLL_NOT_FOUND |
无法找到运行应用程序所必须的库文件 |
ERROR_CANCELLED |
这个函数要求用户提供更多其他信息(译注:比如弹出对话框),但请求用户被取消了 |
ERROR_NOT_ENOUGH_MEMORY |
没有足够的内存来执行操作 |
ERROR_SHARING_VIOLATION |
共享违规发生了 |
Windows
95/98/Me:
函数信息:
Minimum DLL Version |
shell32.dll |
Custom Implementation |
No |
Header |
shellapi.h |
Import library |
shell32.lib |
Minimum operating systems |
Windows NT |
Unicode |
Implemented as ANSI and Unicode versions |
下面举例说明如何使用这个函数,executePackage
-
bool
executePackage(LPCWSTR fileName, LPCWSTR args, LPCWSTR baseDir, bool wait) - {
-
SHELLEXECUTEINFOW sei = { sizeof(SHELLEXECUTEINFOW) }; -
-
sei.fMask = SEE_MASK_NOCLOSEPROCESS | SEE_MASK_FLAG_NO_UI; -
-
sei.lpFile = fileName; -
sei.lpParameters = args; -
sei.lpDirectory = baseDir; -
-
if (!ShellExecuteExW(&sei)) { -
return false; -
} -
-
if (wait) { -
HANDLE hProcess = sei.hProcess; -
if (hProcess != 0) { -
WaitForSingleObject(hProcess, INFINITE); -
CloseHandle(hProcess); -
} -
} -
-
return true; - }
===============================================================================
http://www.cppblog.com/SpringSnow/archive/2009/04/22/80719.html
在日常工作中用到的一些知识,很久没有总结过,前几日参加一个会议,很是无聊。自己思索着自己这两年来所做过的东西,写着写着居然也写下了100个知识点。想把它一条一条总结下来,动笔总不是很容易。就拿这篇文章作为第一篇。
一、SHELLEXECUTEINFO 结构
在MSDN中,它这样定义:
Contains information used by ShellExecuteEx
原型如下:
typedef struct _SHELLEXECUTEINFO{
DWORD cbSize;
ULONG fMask;
HWND hwnd;
LPCTSTR lpVerb;
LPCTSTR lpFile;
LPCTSTR lpParameters;
LPCTSTR lpDirectory;
int nShow;
HINSTANCE hInstApp;
LPVOID lpIDList;
LPCTSTR lpClass;
HKEY hkeyClass;
DWORD dwHotKey;
union {
HANDLE hIcon;
HANDLE hMonitor;
} DUMMYUNIONNAME;
HANDLE hProcess;
} SHELLEXECUTEINFO, *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
时该项被忽略
程序的热键关联,低位存储虚拟关键码(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。对指定应用程序执行某个操作
原型:
BOOLShellExecuteEx(LPSHELLEXECUTEINFO lpExecInfo);
参数:
lpExecInfo
[in, out]
返回值:
如果函数成功执行就返回TRUE,否则返回 FALSE 。可调用 GetLastError 获取错误信息。
备注:
由于ShellExecuteEx 能够将执行委托给那些由组件对象模型COM激活的Shell 扩展(数据源,上下文菜单句柄,动词实现),因此在调用ShellExecuteEx 之前要先初始化 COM。某些Shell 扩展要求单线程单元模型的COM,在这种情况下,应当像下面一般初始化COM:
CoInitializeEx (NULL,COINIT_APARTMENTTHREADED | COINIT_DISABLE_OLE1DDE)
在某些情况下 ShellExecuteEx 并没有使用这种类型的Shell 扩展,这时就无需初始化COM。虽然如此,总是在使用这个函数之前初始化COM是个不错的举措。
三、例子
1、打开一个应用程序
2、如何打开一个文档
3、如何打开一个网页
SHELLEXECUTEINFO ShellInfo;
4、如何启动一个程序,直到它运行结束?
SHELLEXECUTEINFO ShellInfo;
WaitForSingleObject(ShellInfo.hProcess,INFINITE);
四、参考文献
1、MSDN
http://msdn.microsoft.com/en-us/library/bb759784(VS.85).aspx
http://msdn.microsoft.com/en-us/library/bb762154(VS.85).aspx
2、SHELLEXECUTEINFO 结构
http://kaweh.candy.blog.163.com/blog/static/36818772200827352870/
3、说说ShellExecuteEx
http://blog.csdn.net/kesalin/category/242901.aspx