转:ShellExecute函数与ShellExecuteEx函数

ShellExecute函数

ShellExecute函数原型及參数含义例如以下:

  function ShellExecute(hWnd: HWND; Operation, FileName, Parameters,Directory: PChar; ShowCmd: Integer): HINST; stdcall;
  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)的设置确定启动哪个浏览器。 如:ShellExecute(handle,L"open",L" http://www.neu.edu.cn", NULL, NULL, SW_SHOWNORMAL); ShellExecute()函数在HKEY_CLASSES_ROOT\http\shell\open\command下进行搜索。默认浏览器在注冊表HKEY_CLASSES_ROOT\.htm键下的Default设置。

怎样激活相关程序,发送EMAIL?

     假设将FileName參数设置为“mailto:”协议格式,那么该函数将启动默认邮件客户程序,如Microsoft Outlook(也包含Microsoft Outlook Express)或Netscape Messanger。若用户机器中安装了多个邮件客户程序,则该函数将依据Windows 9x/NT注冊表中mailto协议处理程序的设置确定启动哪个邮件客户程序。mailto:用户账号@邮件server地址?subject=邮件主题&body=邮件正文;  如:ShellExecute(handle, L"open", L" mailto:[email protected]?subject=Hello&Body=This is a test", NULL,NULL, SW_SHOWNORMAL);打开新邮件窗体,并自己主动填入收件人地址、邮件主题和邮件正文。若邮件正文包含多行文本,则必须在每行文本之间增加换行转义字符%0a。ShellExecute()函数在HKEY_CLASSES_ROOT\mailto\shell\open\command下搜索。

 怎样打开一个程序?

        ShellExecute(NULL,L"open",L"notepad.exe",  L"c:\\MyLog.log", NULL, SW_SHOW );

怎样用系统打印机打印文档?

        ShellExecute(NULL,L"print", L"c:\\abc.txt",NULL, NULL, SW_HIDE); 

怎样用系统查找功能来查找指定文件?

        ShellExecute(NULL,L"find",L"d:\\nish",  NULL, NULL, SW_SHOW);

怎样启动一个程序,直到它执行结束?

        SHELLEXECUTEINFO ShExecInfo = {0};
        ShExecInfo.cbSize = sizeof(SHELLEXECUTEINFO);
        ShExecInfo.fMask = SEE_MASK_NOCLOSEPROCESS;
        ShExecInfo.hwnd = NULL;
        ShExecInfo.lpVerb = NULL;
        ShExecInfo.lpFile =L"c:\\MyProgram.exe";
        ShExecInfo.lpParameters = NULL;
        ShExecInfo.lpDirectory = NULL;
        ShExecInfo.nShow = SW_SHOW;
        ShExecInfo.hInstApp = NULL;
        ShellExecuteEx(&ShExecInfo);
        WaitForSingleObject(ShExecInfo.hProcess,INFINITE);
或:
       PROCESS_INFORMATION ProcessInfo;
       STARTUPINFO StartupInfo; //This is an [in] parameter
       ZeroMemory(&StartupInfo, sizeof(StartupInfo));
       StartupInfo.cb = sizeof StartupInfo ; //Only compulsory field
       if(CreateProcess(L"c:\\winnt\\notepad.exe", NULL, NULL,NULL,FALSE,0,NULL, NULL,&StartupInfo,&ProcessInfo))
       {
             WaitForSingleObject(ProcessInfo.hProcess,INFINITE);
             CloseHandle(ProcessInfo.hThread);
             CloseHandle(ProcessInfo.hProcess);
       }  
       else

             MessageBox(NULL,L"The process could not be started",NULL,NULL);

怎样显示文件或目录的属性? 

        SHELLEXECUTEINFO ShExecInfo ={0};
        ShExecInfo.cbSize = sizeof(SHELLEXECUTEINFO);
        ShExecInfo.fMask = SEE_MASK_INVOKEIDLIST ;
        ShExecInfo.hwnd = NULL;
        ShExecInfo.lpVerb = L"properties";
        ShExecInfo.lpFile = L"c:\\"; //can be a file as well
        ShExecInfo.lpParameters = NULL;
        ShExecInfo.lpDirectory = NULL;
        ShExecInfo.nShow = SW_SHOW;
        ShExecInfo.hInstApp = NULL;
        ShellExecuteEx(&ShExecInfo);

ShellExecuteEx函数

        此部分转自点击打开链接 

        ShellExecute()有一个难于使用的重大障碍:它不能返回或使你知道新建进程的Handle。也就是说,你不能导出程序并在继续运行之前等待它终止。换句话说ShellExecute()受到了它的16位血统的损害,它只发掘了新的和更有威力的函数CreateProcess()的一个特征子集—WinExec()也支持的子集。然而在4.0以后版本号中引进了一个新函数:ShellExecuteEx()。它有一个Shell函数典型的原型,支持多标志,以及上述全部功能,通过提供对进程同步和PIDLs的支持扩展了ShellExecute()。

        ShellExecuteEx()函数明白地代替了ShellExecute()。它在shellapi.h中声明:BOOL ShellExecuteEx(LPSHELLEXECUTEINFO lpExecInfo);

SHELLEXECUTEINFO定义例如以下:

typedef struct _SHELLEXECUTEINFO

{

DWORD cbSize;

ULONG fMask;

HWND hwnd;

LPCTSTR lpVerb;

LPCTSTR lpFile;

LPCTSTR lpParameters;

LPCTSTR lpDirectory;

int nShow;

HINSTANCE hInstApp;

// 可选的成员

LPVOID lpIDList;

LPCSTR lpClass;

HKEY hkeyClass;

DWORD dwHotKey;

HANDLE hIcon;

HANDLE hProcess;

} SHELLEXECUTEINFO, FAR *LPSHELLEXECUTEINFO;

在使用这个结构之前,我们极力建议你把它充填为0,并设置cbSize到结构的实际长度,操作例如以下:

SHELLEXECUTEINFO sei;

ZeroMemory(&sei, sizeof(SHELLEXECUTEINFO));

sei.cbSize = sizeof(SHELLEXECUTEINFO);

正如声明中的凝视所说,结构的成员分成了两组。实际上,头一组使ShellExecuteEx()的功能等价于ShellExecute()。而选项成员组使函数更有力,这正是‘Ex’后缀的由来。hwnd, lpVerb, lpFile, lpParameters, lpDirectory 和 nShow成员等价于ShellExecute()的參数,这是我们已经看到的。而hInstApp成员则是一个输出缓冲,这将由ShellExecute()的返回值填写。nShow成员总是表示建立窗体的风格,即使lpFile是一个应用程序,它也只说明应用应该如何显示。不管lpFile是应用程序还是文档文件,nShow必须总是赋值为SW_型常量,你是知道的,假设设置为0将获得隐藏窗体。

以下是调用ShellExecuteEx()的最简单方法:

SHELLEXECUTEINFO sei;

ZeroMemory(&sei, sizeof(SHELLEXECUTEINFO));

sei.cbSize = sizeof(SHELLEXECUTEINFO);

sei.lpFile = __TEXT("explorer.exe");

sei.nShow = SW_SHOW;

sei.lpVerb = __TEXT("open");

ShellExecuteEx(&sei);

ShellExecute()中相应參数的成员之中的一个是fMask。它能够是一个或多个以下值的组合

标志                                                                            描写叙述
 
SEE_MASK_CLASSKEY                                        应该使用 hkeyClass 成员

SEE_MASK_CLASSNAME                                    应该使用 lpClass 成员

SEE_MASK_CONNECTNETDRV                        lpFile将被解释成UNC(通用命名习惯)格式的文件名称

SEE_MASK_DOENVSUBST                                 不论什么在lpDirectory和lpFile成员中的环境变量都将被展开,比如,%WINDIR% 打开Windows目录

SEE_MASK_FLAG_DDEWAIT                              假设函数启动DDE会话,在返回之前等待它终止。

SEE_MASK_FLAG_NO_UI                                   在错误情况下不显示消息框

SEE_MASK_HOTKEY                                            应该使用 dwHotkey 成员

SEE_MASK_ICON                                                  应该使用 hIcon 成员

SEE_MASK_IDLIST                                                强制函数使用lpIDList内容取代lpFile

SEE_MASK_INVOKEIDLIST                                 引起函数使用lpIDList中指定的PIDL。假设这个成员为NULL,则建立一个lpFile的PIDL,并使用这个PIDL。这个标志重载了SEE_MASK_IDLIST
SEE_MASK_NOCLOSEPROCESS                     用进程Handle设置hProcess成员。lpIDList成员能够包括一个用于取代lpFile的PIDL。hProcess返回导出的HPROCESS类型的新进程handle

附加的特征

        可选字段适用于某些超出ShellExecute()的附加功能。第一点,也是最重要的一点,能够使用PIDLs来执行应用和打开目录。以下是打开‘打印机’目录的代码:

LPITEMIDLIST pidl;

SHGetSpecialFolderLocation(NULL, CSIDL_PRINTERS, &pidl);

SHELLEXECUTEINFO sei;

ZeroMemory(&sei, sizeof(SHELLEXECUTEINFO));

sei.cbSize = sizeof(SHELLEXECUTEINFO);

sei.nShow = SW_SHOW;

sei.lpIDList = pidl;

sei.fMask = SEE_MASK_INVOKEIDLIST;

sei.lpVerb = __TEXT("open");

ShellExecuteEx(&sei);

         假设指定了SEE_MASK_DOENVSUBST标志,则能够在lpFile和lpDirectory中使用不论什么环境变量。比如,要打开Windows文件夹,能够表示为%WINDIR%。

         最后,我们获得了由ShellExecuteEx()导出的应用的同步能力。在设置了SEE_MASK_NOCLOSEPROCESS位到fMask成员后,新进程的handle将由hProcess成员返回,因此这一行代码:WaitForSingleObject(sei.hProcess, INFINITE);将导致调用的应用堵塞,等待还有一个应用终止。

显示文件属性对话框

    SEE_MASK_INVOKEIDLIST标志是一个重要标志,由于这是ShellExecuteEx()还有一个优于ShellExecute()的亮点:它同意函数象执行静态动词那样唤醒动态动词。前面解释过,动态动词是执行时由Shell扩展的关联菜单加入的。其工作方法是:假设ShellExecuteEx()不能在静态动词列表中找到这个动词,它就试图寻找给定文件的关联菜单。这个搜索引出IContextMenu接口指针。然后通过接口暴露的方法唤醒动态动词。

    作为这个操作的结论,我们能够非常easy地显示文件的属性对话框—与右击文件,然后选择属性显示的对话框同样。这里是一个简单的样例函数:

void ShowFileProperties(LPCTSTR szPathName)

{

SHELLEXECUTEINFO sei;

ZeroMemory(&sei, sizeof(SHELLEXECUTEINFO));

sei.cbSize = sizeof(SHELLEXECUTEINFO);

sei.lpFile = szPathName;

sei.nShow = SW_SHOW;

sei.fMask = SEE_MASK_INVOKEIDLIST;

sei.lpVerb = __TEXT("properties");

ShellExecuteEx(&sei);

}





你可能感兴趣的:(execute)