ShellExecute函数介绍

川长思鸟来 2022-08-12 01:11 212阅读 0赞

ShellExecute的功能是运行一个外部程序（或者是打开一个已注册的文件、打开一个目录、打印一个文件等等），并对外部程序有一定的控制。

使用该函数时，需添加该头文件：

\#include <shellapi.h>

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

ShellExecute(

hWnd: HWND; \{指定父窗口句柄\}

Operation: PChar; \{指定动作, 譬如: open、runas、print、edit、explore、find\}

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

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

Directory: PChar; \{缺省目录\}

ShowCmd: Integer \{打开选项\}

): HINST;

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\}

执行成功会返回 [应用程序][Link 1] 句柄

返回的HINSTANCE可以将它转换为一个整数(%d)，并比较它的值大于还是小于32或比较它的错误代码

返回值大于32表示执行成功

返回值小于32表示执行错误

返回值可能的错误有: = 0 \{  [内存不足][Link 2] \}

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; \{没有相关联的 [应用程序][Link 1] \}

调用计算器

ShellExecute(NULL,"open","calc.exe",NULL,NULL,SW\_SHOWNORMAL);

调用 [记事本][Link 3]

ShellExecute(NULL,"open","NOTEPAD.EXE",NULL,NULL,SW\_SHOWNORMAL);

●hWnd：用于指定父 [窗口句柄][Link 4] 。当 [函数调用][Link 5] 过程出现错误时，它将作为Windows消息窗口的父窗口。例如，可以将其设置为

[应用程序][Link 1] 主 [窗口句柄][Link 4] ，即Application.Handle，也可以将其设置为 [桌面][Link 6] 窗口句柄（用GetDesktopWindow函数获得）。

●Operation：用于指定要进行的操作。其中“open”操作表示执行由FileName参数指定的程序，或打开由FileName参数指定的

文件或文件夹；“print”操作表示打印由FileName参数指定的文件；“explore”操作表示浏览由FileName参数指定的

文件夹。当参数设为nil时，表示执行默认操作“open”。

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

●Parameters：若FileName参数是一个可执行程序，则此参数指定 [命令行参数][Link 7] ，否则此参数应为nil或PChar(0)。

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

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

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

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

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

**   格式一：http://网站域名**

如：ShellExecute(Handle, "open", "http: www.neu.edu.cn", NULL, NULL, SW\_SHOWNORMAL);

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

如：ShellExecute(Handle, "open"," [ http://][http] www.neu.edu.cn/default.htm",NULL,NULL, SW\_SHOWNORMAL);

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

**   格式一：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’,

NULL, NULL, SW\_SHOWNORMAL);打开新邮件窗口，并自动填入收件人地址、邮件主题和邮件正文。若邮件正文包括多行

文本，则必须在每行文本之间加入换行 [转义字符][Link 9] %0a。

例子(delphi):

在一个 [应用程序][Link 1] 调用c:\\Project1.exe;

ShellExecute(handle, 'open',"c:\\Project1.exe",'字串内容',NULL, 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;

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

请用下述任何一个常数

SW\_HIDE 隐藏窗口，活动状态给另一个窗口

SW\_MINIMIZE 最小化窗口，活动状态给另一个窗口

SW\_RESTORE 用原来的大小和位置显示一个窗口，同时令其进入活动状态

SW\_SHOW 用当前的大小和位置显示一个窗口，同时令其进入活动状态

SW\_SHOWMAXIMIZED 最大化窗口，并将其激活

SW\_SHOWMINIMIZED 最小化窗口，并将其激活

SW\_SHOWMINNOACTIVE 最小化一个窗口，同时不改变 [活动窗口][Link 10]

SW\_SHOWNA 用当前的大小和位置显示一个窗口，不改变 [活动窗口][Link 10]

SW\_SHOWNOACTIVATE 用最近的大小和位置显示一个窗口，同时不改变 [活动窗口][Link 10]

SW\_SHOWNORMAL 与SW\_RESTORE相同

[Link 1]: http://baike.baidu.com/view/330120.htm
[Link 2]: http://baike.baidu.com/view/2480679.htm
[Link 3]: http://baike.baidu.com/view/152865.htm
[Link 4]: http://baike.baidu.com/view/1452762.htm
[Link 5]: http://baike.baidu.com/view/2369016.htm
[Link 6]: http://baike.baidu.com/view/79807.htm
[Link 7]: http://baike.baidu.com/view/1646320.htm
[Link 8]: http://baike.baidu.com/view/7718.htm
[http]: http://www.neu.edu.cn/default.htm'%20rel=
[Link 9]: http://baike.baidu.com/view/73.htm
[Link 10]: http://baike.baidu.com/view/1988070.htm