ShellExecute 的使用方法总结

最新推荐文章于 2023-11-03 09:49:14 发布

CreatedSign

最新推荐文章于 2023-11-03 09:49:14 发布

阅读量7.9k

点赞数 5

分类专栏： Window函数学习 Window消息学习文章标签： visual c++ ShellExecute vs2008 windows

本文链接：https://blog.csdn.net/CreatedSign/article/details/18810355

版权

Window函数学习同时被 2 个专栏收录

24 篇文章 0 订阅

订阅专栏

Window消息学习

14 篇文章 0 订阅

订阅专栏

今天来总结一下ShellExecute API 在VC++中编程的使用方法：

一、ShellExecute 的基本介绍

ShellExecute的功能是运行一个外部程序（或者是打开一个已注册的文件、打开一个目录、打印一个文件等等），并对外部程序有一定的控制。有几个API函数都可以实现这些功能，如（WinExec, CreateProcess，后面会有介绍），但是在大多数情况下ShellExecute是更多的被使用的，因为该函数的使用方法简单易用。

二、 ShellExecute 函数的原型

ShellExecute函数原型及参数含义如下：

　　ShellExecute(

　　hWnd: HWND; {指定父窗口句柄，一般为NULL就可以了}

　　Operation: PChar; {指定动作, 譬如: open、print}

　　FileName: PChar; {指定要打开的文件或程序}

　　Parameters: PChar; {给要打开的程序指定参数; 如果打开的是文件这里应该是 NULL}

　　Directory: PChar; {缺省目录, 一般为NULL就可以了}

　　ShowCmd: Integer {打开选项}

返回值： HINST; {执行成功会返回应用程序句柄; 如果这个值 <= 32, 表示执行错误}

　　返回值可能的错误有如下数值：

　　ERROR_FILE_NOT_FOUND = 2; {文件名错误}

　　ERROR_PATH_NOT_FOUND = 3; {路径名错误}

　　ERROR_BAD_FORMAT = 11; {EXE 文件无效}

　　SE_ERR_SHARE = 26; {发生共享错误}

　　SE_ERR_ASSOCINCOMPLETE = 27; {文件名不完全或无效}

　　SE_ERR_DDETIMEOUT = 28; {超时}

　　SE_ERR_DDEFAIL = 29; {DDE 事务失败}

　　SE_ERR_DDEBUSY = 30; {正在处理其他 DDE 事务而不能完成该 DDE 事务}

　　SE_ERR_NOASSOC = 31; {没有相关联的应用程序}

　　//ShowCmd 参数可选值:SW_HIDE = 0; {隐藏}

　　SW_SHOWNORMAL = 1; {用最近的大小和位置显示, 激活}

　　SW_NORMAL = 1; {同 SW_SHOWNORMAL}

　　SW_SHOWMINIMIZED = 2; {最小化, 激活}

　　SW_SHOWMAXIMIZED = 3; {最大化, 激活}

　　SW_MAXIMIZE = 3; {同 SW_SHOWMAXIMIZED}

　　SW_SHOWNOACTIVATE = 4; {用最近的大小和位置显示, 不激活}

　　SW_SHOW = 5; {同 SW_SHOWNORMAL}

　　SW_MINIMIZE = 6; {最小化, 不激活}

　　SW_SHOWMINNOACTIVE = 7; {同 SW_MINIMIZE}

　　SW_SHOWNA = 8; {同 SW_SHOWNOACTIVATE}

　　SW_RESTORE = 9; {同 SW_SHOWNORMAL}

　　SW_SHOWDEFAULT = 10; {同 SW_SHOWNORMAL}

　　SW_MAX = 10; {同 SW_SHOWNORMAL}

三、一般使用举例

　　//调用计算器

　　ShellExecute(NULL,"open","calc.exe",NULL,NULL,SW_SHOWNORMAL);

　　//调用记事本

　　ShellExecute(NULL,"open","NOTEPAD.EXE",NULL,NULL,SW_SHOWNORMAL);

　　●hWnd：用于指定父窗口句柄。当函数调用过程出现错误时，它将作为Windows消息窗口的父窗口。例如，可以将其设置为应用程序主窗口句柄，即Application.Handle，也可以将其设置为桌面窗口句柄（用GetDesktopWindow函数获得）。

　　●Operation：用于指定要进行的操作。其中“open”操作表示执行由FileName参数指定的程序，或打开由FileName参数指定的文件或文件夹；“print”操作表示打印由FileName参数指定的文件；“explore”操作表示浏览由FileName参数指定的文件夹。当参数设为NULL时，表示执行默认操作“open”。

　　●FileName：用于指定要打开的文件名、要执行的程序文件名或要浏览的文件夹名。

　　●Parameters：若FileName参数是一个可执行程序，则此参数指定命令行参数，否则此参数应为NULL。

　　●Directory：用于指定默认目录。

　　●ShowCmd：若FileName参数是一个可执行程序，则此参数指定程序窗口的初始显示方式，否则此参数应设置为0。

　　若ShellExecute函数调用成功，则返回值为被执行程序的实例句柄。若返回值小于32，则表示出现错误。

四、上述仅仅是ShellExecute函数的标准用法，下面将介绍它的特殊用法。

如果将FileName参数设置为“http:”协议格式，那么该函数将打开默认浏览器并链接到指定的URL地址。若用户机器中安装了多个浏览器，则该函数将根据Windows 9x/NT注册表中http协议处理程序（Protocols Handler）的设置确定启动哪个浏览器。

格式一：http://网站域名。为了兼容宽字符和UNICODE，下面的字符串加入了_T()

　　如：ShellExecute(NULL, _T("open"), _T("http:\\www.baidu.com"), NULL, NULL, SW_SHOWNORMAL);

格式二：http://网站域名/网页文件名。

　　如：ShellExecute(Handle, _T ("open"), _T ("http://tieba.baidu.com/home/main?id=b51073756e353173756ecd06&fr=userbar") ,NULL,NULL, SW_SHOWNORMAL);

　　如果将FileName参数设置为“mailto:”协议格式，那么该函数将启动默认邮件客户程序，如Microsoft Outlook（也包括Microsoft Outlook Express）或Netscape Messanger。若用户机器中安装了多个邮件客户程序，则该函数将根据Windows 9x/NT注册表中mailto协议处理程序的设置确定启动哪个邮件客户程序。

注意如果支持UNICODE编码的话，要加上_T()

格式一：mailto:

　　如：ShellExecute(Handle,"open", "mailto:", NULL, NULL, SW_SHOWNORMAL);打开新邮件窗口。

格式二：mailto:用户账号@邮件服务器地址

　　如：ShellExecute(Handle, "open"," mailto:who@mail.neu.edu.cn", NULL, NULL, SW_SHOWNORMAL);打开新邮件窗口，并自动填入收件人地址。若指定多个收件人地址，则收件人地址之间必须用分号或逗号分隔开（下同）。

格式三：mailto:用户账号@邮件服务器地址?

　subject=邮件主题＆body=邮件正文

　　如：ShellExecute(handle, ‘open’, ‘ mailto:who@mail.neu.edu.cn？subject=Hello＆Body=This is a test’, nil, nil, SW_SHOWNORMAL);打开新邮件窗口，并自动填入收件人地址、邮件主题和邮件正文。若邮件正文包括多行文本，则必须在每行文本之间加入换行转义字符％0a。

　　例子(delphi):

　　在一个应用程序调用c:\Project1.exe;

　　ShellExecute(handle, 'open','c:\Project1.exe','字串内容',nil, SW_SHOWNORMAL);

　　在Project1.exe里可以调用:

　　procedure TForm1.FormCreate(Sender: TObject);

　　var i:integer;

　　begin

　　for i:=1 to paramcount do

　　if ParamStr(i)<>'' then showmessage(ParamStr(i));

　　end;

　　最后的那个参数，为窗口指定可视性方面的一个命令。

　　请用下述任何一个常数