ShellExecute的功能是运行一个外部程式（或者是打开一个已注册的档案、打开一个目录、列印一个档案等等），并对外部程式有一定的控制。有几个API函式都可以实现这些功能，但是在大多数情况下ShellExecute是更多的被使用的，同时它并不是太複杂。
基本介绍
- 外文名：ShellExecute
- 作用：运行并控制一个外部程式
- 领域：编程
- 函式类型：API函式
原型参数
注意事项：使用该函式时，需添加该头档案：
#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}
返回值
执行成功会返回应用程式句柄
返回的HINSTANCE可以将它转换为一个整数(%d)，并比较它的值大于还是小于32或比较它的错误代码
返回值大于32表示执行成功
返回值小于32表示执行错误
返回值可能的错误有: = 0 {记忆体不足}
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; {没有相关联的应用程式}
例子
首先记得加上头档案<windows.h>
//调用计算器
ShellExecute(0,"open","calc.exe","","",SW_SHOWNORMAL);
如果是C++语言，可能会出现参数类型不兼容的情况，改为：
ShellExecute(0,(LPCWSTR)L"open",(LPCWSTR)L"CALC.EXE",(LPCWSTR)L"",(LPCWSTR)L"",SW_SHOWNORMAL);
（下同）
//调用记事本
ShellExecute(0,"open","NOTEPAD.EXE","","",SW_SHOWNORMAL);
●hWnd：用于指定父视窗句柄。当函式调用过程出现错误时，它将作为Windows讯息视窗的父视窗。例如，可以将其设定为应用程式主视窗句柄，即Application.Handle，也可以将其设定为桌面视窗句柄（用GetDesktopWindow函式获得）。
●Operation：用于指定要进行的操作。其中“open”操作表示执行由FileName参数指定的程式，或打开由FileName参数指定的档案或资料夹；“print”操作表示列印由FileName参数指定的档案；“explore”操作表示浏览由FileName参数指定的资料夹。当参数设为nil时，表示执行默认操作“open”。
●FileName：用于指定要打开的档案名称、要执行的程式档案名称或要浏览的资料夹名。
●Parameters：若FileName参数是一个可执行程式，则此参数指定命令行参数，否则此参数应为nil或PChar(0)。
●Directory：用于指定默认目录。
●ShowCmd：若FileName参数是一个可执行程式，则此参数指定程式视窗的初始显示方式，否则此参数应设定为0。
若ShellExecute函式调用成功，则返回值为被执行程式的实例句柄。若返回值小于32，则表示出现错误。
上述仅仅是ShellExecute函式的标準用法，下面将介绍它的特殊用法。
特殊用法
如果将FileName参数设定为“http:”协定格式，那幺该函式将打开默认浏览器并连结到指定的URL地址。若用户机器中安装了多个浏览器，则该函式将根据Windows 9x/NT注册表中http协定处理程式（Protocols Handler）的设定确定启动哪个浏览器。
格式一：http://网站域名
如：ShellExecute(Handle, "open", "http:// ;
www.neu.edu.cn", "", "", SW_SHOWNORMAL);
格式二：http://网站域名/网页档案名称
如：ShellExecute(Handle, "open"," http:// ;
www.neu.edu.cn/default.htm","","",
SW_SHOWNORMAL);
如果将FileName参数设定为“mailto:”协定格式，那幺该函式将启动默认邮件客户程式，如Microsoft Outlook（也包括Microsoft Outlook Express）或Netscape Messanger。若用户机器中安装了多个邮件客户程式，则该函式将根据Windows 9x/NT注册表中mailto协定处理程式的设定确定启动哪个邮件客户程式。
格式一：mailto
如：ShellExecute(Handle,"open", "mailto:", "", "", SW_SHOWNORMAL);打开新邮件视窗。
格式二：mailto:用户账号@邮件伺服器地址
如：ShellExecute(Handle, "open"," mailto:who@mail.neu.edu.cn", "", "", SW_SHOWNORMAL);打开新邮件视窗，并自动填入收件人地址。若指定多个收件人地址，则收件人地址之间必须用分号或逗号分隔开（下同）。
格式三：mailto:用户账号@邮件伺服器地址
subject=邮件主题&body=邮件正文
如：ShellExecute(handle, ‘open’, ‘ mailto:who@mail.neu.edu.cn？subject=Hello&Body=This is a test’,"", "", SW_SHOWNORMAL);打开新邮件视窗，并自动填入收件人地址、邮件主题和邮件正文。若邮件正文包括多行文本，则必须在每行文本之间加入换行转义字元%0a。
例子(delphi):
在一个应用程式调用c:\Project1.exe;
ShellExecute(handle, 'open',"c:\Project1.exe",'字串内容',"", SW_SHOWNORMAL);
在Project1.exe里可以调用:
procedure TForm1.FormCreate(Sender: TObject);var i:integer;beginfor i:=1 to paramcount doif ParamStr(i)<>'' then showmessage(ParamStr(i));end;
最后的那个参数，为视窗指定可视性方面的一个命令。
请用下述任何一个常数
SW_HIDE 隐藏视窗，活动状态给另一个视窗
SW_MINIMIZE 最小化视窗，活动状态给另一个视窗
SW_RESTORE 用原来的大小和位置显示一个视窗，同时令其进入活动状态
SW_SHOW 用当前的大小和位置显示一个视窗，同时令其进入活动状态
SW_SHOWMAXIMIZED 最大化视窗，并将其激活
SW_SHOWMINIMIZED 最小化视窗，并将其激活
SW_SHOWMINNOACTIVE 最小化一个视窗，同时不改变活动视窗
SW_SHOWNA 用当前的大小和位置显示一个视窗，不改变活动视窗
SW_SHOWNOACTIVATE 用最近的大小和位置显示一个视窗，同时不改变活动视窗
SW_SHOWNORMAL 与SW_RESTORE相同
VB语言
概括
可以使用 Windows API ShellExecute() 函式来启动与给定的文档扩展名关联而无需知道关联应用程式的名称的应用程式。例如，您无法通过传递档案名称拱廊启动画笔程式。BMP 的 ShellExecute() 函式。
定义声明
ShellExecute 函式打开，则列印指定的档案。下面是从 Visual Basic 中调用此函式时要使用的声明：
Declare Function ShellExecute Lib "shell32.dll" Alias "ShellExecuteA" _(ByVal hwnd As Long, ByVal lpszOp As String, _ByVal lpszFile As String, ByVal lpszParams As String, _ByVal LpszDir As String, ByVal FsShowCmd As Long) _As Long
参数说明
hwnd
标识父视窗。该视窗可以接收任何 讯息框的应用程式产生（例如，用于错误报告).
lpszOp
指向一个空结束的字元串，指定执行的操作。这个字元串可以是“open”或“列印”。如果这个参数为""，“open”是默认值。
lpszFile
指向一个空结束的字元串，指定档案
lpszParams
指向一个空结束的字元串指定参数 传递给应用程式时lpszFile参数所 指定一个执行档。如果lpszFile指向一个文档档案，该参数为""。
LpszDir
指向一个空结束的字元串指定默认目录。
FsShowCmd
指定应用程式视窗是否被显示时 该应用程式被打开。
示例
下面的示例演示如何启动一个应用程式或将文档载入到其关联的应用程式。Windows API ShellExecute() 函式是文档的不同于 Visual Basic Shell() 函式，可以将 ShellExecute() 函式传递的名称，它将启动关联的应用程式，然后将档案名称传递给应用程式。
- 在 Visual Basic 中开始一个新项目。默认情况下，将创建 Form1。
- 将以下代码添加到 Form1 的通用声明部分：
Option ExplicitPrivate Declare Function ShellExecute Lib "shell32.dll" Alias "ShellExecuteA" (ByVal hwnd As Long, ByVal lpszOp As String, ByVal lpszFile As String, ByVal lpszParams As String,ByVal lpszDir As String, ByVal FsShowCmd As Long) As LongPrivate Declare Function GetDesktopWindow Lib "user32" () As LongConst SW_SHOWNORMAL = 1Const SE_ERR_FNF = 2&Const SE_ERR_PNF = 3&Const SE_ERR_ACCESSDENIED = 5&Const SE_ERR_OOM = 8& Const SE_ERR_DLLNOTFOUND = 32&Const SE_ERR_SHARE = 26&Const SE_ERR_ASSOCINCOMPLETE = 27&Const SE_ERR_DDETIMEOUT = 28&Const SE_ERR_DDEFAIL = 29&Const SE_ERR_DDEBUSY = 30&Const SE_ERR_NOASSOC = 31&Const ERROR_BAD_FORMAT = 11&Function StartDoc(DocName As String) As Long Dim Scr_hDC As Long Scr_hDC = GetDesktopWindow() StartDoc = ShellExecute(Scr_hDC, "Open", DocName, "", "C:\", SW_SHOWNORMAL)End FunctionPrivate Sub Form_Click() Dim r As Long, msg As String r = StartDoc("C:\WINDOWS\ARCADE.BMP") If r <= 32 Then 'There was an error Select Case r Case SE_ERR_FNF msg = "File not found" Case SE_ERR_PNF msg = "Path not found" Case SE_ERR_ACCESSDENIED msg = "Access denied" Case SE_ERR_OOM msg = "Out of memory" Case SE_ERR_DLLNOTFOUND msg = "DLL not found" Case SE_ERR_SHARE msg = "A sharing violation occurred" Case SE_ERR_ASSOCINCOMPLETE msg = "Incomplete or invalid file association" Case SE_ERR_DDETIMEOUT msg = "DDE Time out" Case SE_ERR_DDEFAIL msg = "DDE transaction failed" Case SE_ERR_DDEBUSY msg = "DDE busy" Case SE_ERR_NOASSOC msg = "No association for file extension" Case ERROR_BAD_FORMAT msg = "Invalid EXE file or error in EXE image" Case Else msg = "Unknown error" End Select MsgBox msg End IfEnd Sub
