加载中…
个人资料
微博
  • 博客等级：
  • 博客积分：
  • 博客访问：
  • 关注人气：
  • 获赠金笔：0支
  • 赠出金笔：0支
  • 荣誉徽章：
正文 字体大小：大 中 小

ShellExecuteEx(转载)

(2012-05-31 12:56:53)
标签：

杂谈

 分类： C和Cplusplus

http://blog.csdn.net/kesalin/article/details/4076061#

 

今天来说说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 被声明成一个句柄，但它并不是一个句柄。它只能被转型为整数，并同32或SE_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 这个函数用来执行某个应用程序。

 

  1. bool executePackage(LPCWSTR fileName, LPCWSTR args, LPCWSTR baseDir, bool wait)  
  2. {  
  3.     SHELLEXECUTEINFOW sei = { sizeof(SHELLEXECUTEINFOW) };  
  4.   
  5.     sei.fMask = SEE_MASK_NOCLOSEPROCESS | SEE_MASK_FLAG_NO_UI;  
  6.   
  7.     sei.lpFile = fileName;  
  8.     sei.lpParameters = args;  
  9.     sei.lpDirectory = baseDir;  
  10.   
  11.     if (!ShellExecuteExW(&sei)) {  
  12.         return false;  
  13.     }  
  14.   
  15.     if (wait) {  
  16.         HANDLE hProcess = sei.hProcess;  
  17.         if (hProcess != 0) {  
  18.             WaitForSingleObject(hProcess, INFINITE);  
  19.             CloseHandle(hProcess);  
  20.         }  
  21.     }  
  22.   
  23.     return true;  
  24. }  

===============================================================================

http://www.cppblog.com/SpringSnow/archive/2009/04/22/80719.html

题目：

在日常工作中用到的一些知识，很久没有总结过，前几日参加一个会议，很是无聊。自己思索着自己这两年来所做过的东西，写着写着居然也写下了100个知识点。想把它一条一条总结下来，动笔总不是很容易。就拿这篇文章作为第一篇。

        很多东西取之于网络，也有一些自己的心得。才疏学浅，就当一个知识梳理的过程吧。
        
 第一篇 SHELLEXECUTEINFO 和 ShellExecuteEx的使用

        使用SHELLEXECUTEINFO和ShellExecuteEx，我也主要是在cab包的安装时使用的。基本上是这样使用的，如下：

 

     SHELLEXECUTEINFO ShellInfo;

             

     memset(&ShellInfo, 0, sizeof(ShellInfo));

     ShellInfo.cbSize = sizeof(ShellInfo);

     ShellInfo.hwnd = NULL;

     ShellInfo.lpVerb = _T("open");

     ShellInfo.lpFile = szFilePath;

     ShellInfo.nShow = SW_SHOWNORMAL;

     ShellInfo.fMask = SEE_MASK_NOCLOSEPROCESS;

 

     BOOL bResult = ShellExecuteEx(&ShellInfo);

一、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时该项被忽略

 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、打开一个应用程序

     SHELLEXECUTEINFO ShellInfo;

             

     memset(&ShellInfo, 0, sizeof(ShellInfo));

     ShellInfo.cbSize = sizeof(ShellInfo);

     ShellInfo.hwnd = NULL;

     ShellInfo.lpVerb = _T("open");

     ShellInfo.lpFile = szFilePath; // 此处写执行文件的绝对路径

     ShellInfo.nShow = SW_SHOWNORMAL;

     ShellInfo.fMask = SEE_MASK_NOCLOSEPROCESS;

 

     BOOL bResult = ShellExecuteEx(&ShellInfo);

2、如何打开一个文档

   程序代码如上

3、如何打开一个网页

SHELLEXECUTEINFO ShellInfo;

             

     memset(&ShellInfo, 0, sizeof(ShellInfo));

     ShellInfo.cbSize = sizeof(ShellInfo);

     ShellInfo.hwnd = NULL;

     ShellInfo.lpVerb = _T("open");

     ShellInfo.lpFile = _T("http://www.sina.com");

     ShellInfo.nShow = SW_SHOWNORMAL;

     ShellInfo.fMask = SEE_MASK_NOCLOSEPROCESS;

 

     BOOL bResult = ShellExecuteEx(&ShellInfo);

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

SHELLEXECUTEINFO ShellInfo;

             

     memset(&ShellInfo, 0, sizeof(ShellInfo));

     ShellInfo.cbSize = sizeof(ShellInfo);

     ShellInfo.hwnd = NULL;

     ShellInfo.lpVerb = _T("open");

     ShellInfo.lpFile = szFilePath;

     ShellInfo.nShow = SW_SHOWNORMAL;

     ShellInfo.fMask = SEE_MASK_NOCLOSEPROCESS;

     ShellExecuteEx(&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

喜欢

0

阅读┊ 收藏 ┊ 喜欢▼ ┊打印┊举报/Report
  

新浪BLOG意见反馈留言板　欢迎批评指正

新浪简介 | About Sina | 广告服务 | 联系我们 | 招聘信息 | 网站律师 | SINA English | 产品答疑

Copyright © 1996 - 2022 SINA Corporation, All Rights Reserved

新浪公司 版权所有