首页 > 代码库 > 说说ShellExecuteEx

说说ShellExecuteEx

今天来说说ShellExecuteEx这个函数,先翻译MSDN,然后看个样例。

 

ShellExecuteEx Function

对指定应用程序运行某个操作

语法:

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是个不错的举措。

假设有多个显示器,而且你指定了一个HWND 同一时候设置lpExecInfo 的成员lpVerb "Properties",那么由ShellExecuteEx 创建的不论什么窗体都有可能显示在不对的位置上。

假设这个函数运行成功,它会设置 SHELLEXECUTEINFO hInstApp 成员为一个大于32的值。假设函数运行失败,hInstApp 成员被设置为SE_ERR_XXX(提示失败的原因)。尽管为了兼容16位的windows应用程序hInstApp 被声明成一个句柄,但它并非一个句柄。它仅仅能被转型为整数,并同32SE_ERR_XXX之类的错误代码比較。

提供SE_ERR_XXX 之类的错误代码是为了兼容ShellExecute使用GetLastError能够获得更具体的错误信息。返回值能够使下列之中的一个:

Error

Description

ERROR_FILE_NOT_FOUND

指定文件不存在

ERROR_PATH_NOT_FOUND

指定路径不存在

ERROR_DDE_FAIL

动态数据交换 (DDE) 处理失败

ERROR_NO_ASSOCIATION

没有与制定文件名称扩展相应的应用程序

ERROR_ACCESS_DENIED

訪问指定文件被拒绝

ERROR_DLL_NOT_FOUND

无法找到执行应用程序所必须的库文件

ERROR_CANCELLED

这个函数要求用户提供很多其它其它信息(译注:比方弹出对话框),但请求用户被取消了

ERROR_NOT_ENOUGH_MEMORY

没有足够的内存来运行操作

ERROR_SHARING_VIOLATION

共享违规发生了

Windows 95/98/Me: ShellExecuteEx Microsoft Layer for Unicode (MSLU)所支持。为了使用这个函数,必须加入额外的文件到应用程序中去,请參考:Microsoft Layer for Unicode on Windows Me/98/95 Systems.

 

函数信息:

Minimum DLL Version

shell32.dll version 3.51 or later

Custom Implementation

No

Header

shellapi.h

Import library

shell32.lib

Minimum operating systems

Windows NT 4.0, Windows 95

Unicode

Implemented as ANSI and Unicode versions

 

 

 

以下举例说明怎样使用这个函数,executePackage 这个函数用来运行某个应用程序。

 

 

说说ShellExecuteEx