功能强大的ShellExecute

来源：互联网发布：幼儿园知乎编辑：程序博客网时间：2024/05/16 02:48

转自：百度百科

#include <shellapi.h>

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

ShellExecute(

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

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

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}

3返回值编辑

执行成功会返回应用程序句柄

返回的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; {没有相关联的应用程序}

4例子编辑

//调用计算器

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参数指定的文件夹。当参数设为nil时，表示执行默认操作“open”。

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

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

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

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

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

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

5特殊用法编辑

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

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

如：ShellExecute(Handle, "open", "http:// ;

www.neu.edu.cn", NULL, NULL, SW_SHOWNORMAL);

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

如：ShellExecute(Handle, "open"," 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);打开新邮件窗口，并自动填入收件人地址、邮件主题和邮件正文。若邮件正文包括多行文本，则必须在每行文本之间加入换行转义字符%0a。

例子(delphi):

在一个应用程序调用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 最小化一个窗口，同时不改变活动窗口

SW_SHOWNA 用当前的大小和位置显示一个窗口，不改变活动窗口

SW_SHOWNOACTIVATE 用最近的大小和位置显示一个窗口，同时不改变活动窗口

SW_SHOWNORMAL 与SW_RESTORE相同

6VB语言编辑

概括

可以使用 Windows API ShellExecute() 函数来启动与给定的文档扩展名关联而无需知道关联应用程序的名称的应用程序。例如，您无法通过传递文件名拱廊启动画笔程序。BMP 的 ShellExecute() 函数。

定义声明

ShellExecute 函数打开，则打印指定的文件。下面是从 Visual Basic 中调用此函数时要使用的声明：

1
DeclareFunction ShellExecute Lib"shell32.dll" Alias "ShellExecuteA" _                   (ByValhwnd AsLong,ByVallpszOp AsString, _                    ByVallpszFile AsString,ByVallpszParams AsString, _                    ByValLpszDir AsString,ByValFsShowCmd AsLong) _                    AsLong               

参数说明

hwnd

标识父窗口。该窗口可以接收任何消息框的应用程序产生（例如，用于错误报告).

lpszOp

指向一个空结束的字符串指定的操作执行。这个字符串可以是“开放式”或“打印”。如果这参数为NULL，“开放”是默认值。

lpszFile指向一个空结束的字符串指定文件开。lpszParams

指向一个空结束的字符串指定参数传递给应用程序时lpszFile参数所指定一个可执行文件。如果lpszFile指向一个字符串指定一个文档文件，该参数为NULL。

LpszDir

指向一个空结束的字符串指定默认目录。

FsShowCmd

指定应用程序窗口是否被显示时该应用程序被打开。

示例

下面的示例演示如何启动一个应用程序或将文档加载到其关联的应用程序。Windows API ShellExecute() 函数是文档的不同于 Visual Basic Shell() 函数，可以将 ShellExecute() 函数传递的名称，它将启动关联的应用程序，然后将文件名传递给应用程序。

在 Visual Basic 中开始一个新项目。默认情况下，将创建 Form1。
将以下代码添加到 Form1 的通用声明部分：

1
OptionExplicit      PrivateDeclare Function ShellExecute Lib"shell32.dll" Alias _      "ShellExecuteA"(ByValhwnd AsLong,ByVallpszOp As_      String,ByVallpszFile AsString,ByVallpszParams AsString, _      ByVallpszDir AsString,ByValFsShowCmd AsLong)AsLong      Private Declare Function GetDesktopWindow Lib"user32" () AsLong      Const SW_SHOWNORMAL = 1      ConstSE_ERR_FNF = 2&      ConstSE_ERR_PNF = 3&      ConstSE_ERR_ACCESSDENIED = 5&      ConstSE_ERR_OOM = 8&      ConstSE_ERR_DLLNOTFOUND = 32&      ConstSE_ERR_SHARE = 26&      ConstSE_ERR_ASSOCINCOMPLETE = 27&      ConstSE_ERR_DDETIMEOUT = 28&      ConstSE_ERR_DDEFAIL = 29&      ConstSE_ERR_DDEBUSY = 30&      ConstSE_ERR_NOASSOC = 31&      ConstERROR_BAD_FORMAT = 11&      FunctionStartDoc(DocName AsString)AsLong          Dim Scr_hDC AsLong          Scr_hDC = GetDesktopWindow()          StartDoc = ShellExecute(Scr_hDC, "Open", DocName, _          "","C:\", SW_SHOWNORMAL)      End Function      Private 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"              EndSelect              MsgBox msg          EndIf      End Sub       

参考资料

0 0