让程序只运行一个实例

标题　: 让程序只运行一个实例
关键字:
分类　: 个人专区
密级　: 公开
(评分: , 回复: 0, 阅读: 224) ??
让程序只运行一个实例

Windows 下一个典型的特征就是多任务，我们可以同时打开多个窗口进行操作，也可以同时运行程序的多个实例，比如可以打开许多个资源管理器进行文件的移动复制操作。但有时出于某种考虑（比如安全性），我们要做出一些限制，让程序只能够运行一个实例。在Delphi编程中，笔者总结出了以下几种方法：
一、 查找窗口法
这是最为简单的一种方法。在程序运行前用FindWindow函数查找具有相同窗口类名和标题的窗口，如果找到了，就说明已经存在一个实例。在项目源文件的初始化部分添加以下代码：
Program OneApp
Uses
Forms,Windows;（这里介绍的几种方法均需在项目源文件中添加Windows单元，以后不再重复了）
Var Hwnd:Thandle;
Begin
Hwnd:=FindWindow(‘TForm1’，‘SingleApp’);
If Hwnd=0 then
Begin
Application.Initialize;
Application.CreateForm(Tform1, Form1);
Application.Run;
End;
End;
FindWindow()函数带两个参数，其中的一个参数可以忽略，但笔者强烈建议将两个参数都用上，免得凑巧别的程序也在使用相同的类名，就得不到正确的结果了。另外，如果是在Delphi IDE窗口中运行该程序，将一次都不能运行，因为已经存在相同类名和标题的窗口：设计时的窗体。
二、使用互斥对象
如果觉得查找窗口的方法效率不太高的话，可以使用创建互斥对象的方法。尽管互斥对象通常用于同步连接，但用在这个地方也是非常方便的。仅用了4句代码就轻松搞定。
VAR Mutex:THandle;
begin
Mutex:=CreateMutex(NIL,True,‘SingleApp’);
IF GetLastError<>ERROR_ALREADY_EXISTS THEN//如果不存在另一实例
BEGIN
Application.CreateHandle;
Application.CreateForm (TExpNoteForm, ExpNoteForm);
Application.Run;
END;
ReleaseMutex(Mutex);
end.
三、全局原子法
我们也可以利用向系统添加全局原子的方法，来防止多个程序实例的运行。全局原子由Windows 系统负责维持，它能保证其中的每个原子都是唯一的，管理其引用计数，并且当该全局原子的引用计数为0时，从内存中清除。我们用GlobalAddAtom 函数向全局原子添加一个255个字节以内的字符串，用GlobalFindAtom来检查是否已经存在该全局原子，最后在程序结束时用GlobalDeleteAtom函数删除添加的全局原子。示例如下：
Uses Windows
const iAtom=‘SingleApp’;
begin
if GlobalFindAtom(iAtom)=0 then
begin
GlobalAddAtom(i

Atom);
Application.Initialize;
Application.CreateForm(TForm1,Form1);
Application.Run;
GlobalDeleteAtom(GlobalFindAtom(iAtom));
end
else
MessageBox(0,‘You can not run a second copy of this App’,‘’,mb_OK);
end.
利用全局原子的引用计数规则，我们还可以判断当前共运行了该程序的多少个实例：
var i:Integer;
begin
I:=0;
while GlobalFindAtom(iAtom)<>0 do
begin
GlobalDeleteAtom(GlobalFindAtom(iAtom));
i:=i＋1;
end;
ShowMessage(IntToStr(I));
end;
以上几种方法在笔者的Delphi 4.0，中文Windows95下通过。

-----------------------------------------------------------------
以下程序在我的D7中验证可用
program SunnyXF;

uses
Forms,
Windows, //CreateMutex等WinApi函数

FrmMain in 'FrmMain.pas' {MainForm};


{$R *.res}

var
hAppMutex: THandle;

begin
Application.Initialize;

//创建互斥对象, If CreateMutex succeeds, the return value is a handle to the mutex object.
//If the named mutex object existed before the function call, the GetLastError function returns ERROR_ALREADY_EXISTS. Otherwise, GetLastError returns zero.
hAppMutex := CreateMutex(nil, false, PChar('SingleInstance'));
if (hAppMutex = 0) then
begin
MessageBox(0,PChar('创建互斥对象失败!'),PChar('错误'), MB_OK + MB_ICONINFORMATION);
exit;
end;
//查看是否是第一次运行程序
if ((hAppMutex <> 0) and (GetLastError() = ERROR_ALREADY_EXISTS)) then
begin
MessageBox(0,PChar('程序已经运行, 按确定关闭此窗口!'),PChar('提示'), MB_OK + MB_ICONINFORMATION);
end
else
begin
Application.CreateForm(TMainForm, MainForm);
Application.Run;
end;

//ReleaseMutex(hAppMutex); ReleaseMutex或CloseHandle都起作用
CloseHandle(hAppMutex);

end.

注意点:
1.在User中，要把Windows放在Form前头；

2.开始创建互斥对象的代码要在Application.Initialize之后；

3.关闭互斥对象操作要放在Application.Run之后；







标题　: 防止同时出现多个应用程序实例
关键字: Mutex
分类　: 个人专区
密级　: 公开
(评分: , 回复: 0, 阅读: 488) ??
方法一：使用互斥对象
方法二：列举系统中所有进程，判断是否已运行

一：use Mutex

Windows API 提供了函数FindWindow，可以是应用程序在启动时检查自己是否已经存在。 该函数在Delphi中的语法为：
function FindWindow(lpClassName: PChar, lpWindowName: PChar): HWND;
其中，参数lpCalssName 是要查找的窗口的类的名称，参数lpWindowName是要查找的窗口的标题(Caption)。 如果找到了相应的窗口实例，将返回一个非0 的该窗口句柄的整型值，否则返回0 。因此，只要判断应用程序的主窗口（或

者伴随着应用程序存在而存在的窗口）是否存在就可以判断是否已经有实例存在了。
例如：
H := FindWindow('TForm1', nil);
if H = 0 then begin
ShowMessage('没有发现相同的应用程序实例。');
//加入加载应用程序的语句
//...
end else begin
ShowMessage('应用程序已经加载。');
SetActiveWindow(H);
end;

其中，参数lpWindowName的位置以Delphi保留字nil 代替，是因为窗口的标题可能在应用程序中是变化的。Windows API 函数SetActiveWindow 用于指定活动窗口。

但是，这种方法有两个缺陷：一是它只能基于窗口类名或标题来搜索窗口，但是在整个系统中窗口很可能会重复。所以，这样做是不可靠的。而利用窗口的标题的方法也有问题，因为窗口的标题有可能发生变化(以Delphi和Word为例，每次打开不同文件，它们的标题都会变化)，所以这种方法不可取。另一个缺陷是它每次搜索都要遍历所有窗口，这样执行进来非常慢。

因此，在Win32系统中最好的解决方案是利用那些不依赖于进程的API对象，并且它们的使用也很简单，互斥对象就可以解决这个问题。当一个应用程序首次运行时，我们就使一个互斥对象被API函数CreateMutex()创建。这个函数的参数lpName是一个唯一标识互斥对象的字符串。当应用程序的实例要运行前，它首先要用OpenMutex()来打开互斥对象，如果已经有一个CreateMutex()创建的互斥对象则返回非零值。另外，当试图运行另一个程序实例时，使第一个实例被激活。
对于这个问题，最好的解决方法是在首次运行时，利用RegisterWindowMessage()函数注册一个消息，并在应用程序中创建唯一的消息标识符。然后，利用第一个实例对这个消息的响应使它被第二个实例激活。
下面介绍两种实现方法，均在Delphi7，Win2000/XP下测试通过。

1 、这种方法阻止新实例的产生，但不能提前，不过较简便。我就是采用这种方法：）
在Project的Program文件中
[codes=delphi]
program KS_Kd_Srv;

uses
Windows,
Forms,
ShellApi,
SysUtils,
.....;

{$R *.TLB}

{$R *.res}
var
HMutex:Hwnd;
Ret:Integer;
begin

Application.Initialize;
aTitle := '考场应用服务器';
//Application.Title := aTitle; //Application.Title不能接受变量的值，怪了
Application.Title := '考场应用服务器';

HMutex:=CreateMutex(nil,False,Pchar(aTitle)); //建立互斥对象，名字为aTitle--'考场应用服务器'
Ret:=GetLastError;
If Ret<>ERROR_ALREADY_EXISTS Then
begin
... //做我们正常该做的事情
end else
ReleaseMutex(hMutex); //防止创建多个程序实例 有人在此用 Halt(0);结束应用程序，明显不好！

Application.Run;

end.
[/codes][newpage]
2 、在《Delphi 5 开发人员指南》中第13章中有一篇“防止同时出现多个应用程序实例”，代码中给出了一个MultInst.pas单元，工程引用此单元就能防止同时出现多个实例，
但实际应用中发现, 如果应用程序并没有最小化，第二个实例不能把第一个实例提到最前。
下面是我改写的MultInst.pas单元，能解决这个小问题。这里参考了ysai的代码。
[codes=delphi]
//==============================================================================
// Unit Name: MultInst
// Author : xieyunc
// Date : 2003-05-20
// Purpose : 解决应用程序多实例问题
// History :
//==============================================================================

//==============================================================================
// 工作流程
// 程序运行先取代原有向所有消息处理过程,然后广播一个消息.
// 如果有其它实例运行,收到广播消息会回发消息给发送程序,并传回它自己的句柄
// 发送程序接收到此消息,激活收到消息的程序,然后关闭自己
//==============================================================================
unit MultInst;

interface

uses
Windows ,Messages, SysUtils, Classes, Forms;

implementation

const
STR_UNIQUE = '{2BE6D96E-827F-4BF9-B33E-8740412CDE96}';
MI_ACTIVEAPP = 1; //激活应用程序
MI_GETHANDLE = 2; //取得句柄

var
iMessageID : Integer;
OldWProc : TFNWndProc;
MutHandle : THandle;
BSMRecipients : DWORD;

function NewWndProc(Handle: HWND; Msg: Integer; wParam, lParam: Longint):
Longint; stdcall;
begin
Result := 0;
if Msg = iMessageID then
begin
case wParam of
MI_ACTIVEAPP: //激活应用程序
if lParam<>0 then
begin
//收到消息的激活前一个实例
//为什么要在另一个程序中激活?
//因为在同一个进程中SetForegroundWindow并不能把窗体提到最前
if IsIconic(lParam) then
OpenIcon(lParam)
else
SetForegroundWindow(lParam);
//终止本实例
Application.Terminate;
end;
MI_GETHANDLE: //取得程序句柄
begin
PostMessage(HWND(lParam), iMessageID, MI_ACTIVEAPP,
Application.Handle);
end;
end;
end
else
Result := CallWindowProc(OldWProc, Handle, Msg, wParam, lParam);
end;

procedure InitInstance;
begin
//取代应用程序的消息处理
OldWProc := TFNWndProc(SetWindowLong(Application.Handle, GWL_WNDPROC,
Longint(@NewWndProc)));

//打开互斥对象
MutHandle := OpenMutex(MUTEX_ALL_ACCESS, False, STR_UNIQUE);
if MutHandle = 0 then
begin
//建立互斥对象
MutHandle := CreateMutex(nil, False, STR_UNIQUE);
end
else begin
Application.ShowMainForm := False;

//已经有程序实例,广播消息取得实例句柄
BSMRecipients := BSM_APPLICATIONS;
BroadCastSystemMessage(BSF_IGNORECURRENTTASK or BSF_POSTMESSAGE,
@BSMRecipients, iMessageID, MI_GETHANDLE,Application.Handle);
end;
end;

initialization
//注册消息
iMessageID := RegisterWindowMessage(STR_UNIQUE);
InitInstance;

finalization
//还原消息处理过程
if OldWProc <> Nil then
SetWindowLong(Application.Handle, GWL_WNDPROC, LongInt(OldWProc));

//关闭互斥对象
if MutHandle <> 0 then CloseHandle(MutHandle);

end.
//使用方法很简单，只要把此单元加入工程就可以了。
[/codes][file]attachment/multinst.rar[/file]
但是这种方法由于是在新的实例MainForm.create后中止新实例，同时把旧实例提前，故还存在两点不足：
1、假设我们的Application.ShowMainForm设为FALSE，但是如果在MainForm.Create之前调用了其他如Flash界面，仍然会短暂的显示出来。
2、如果在同一工程组的中的多个应用程序都包含了此文件的话，那么不同的应用程序也会互斥！

二
以上方法有弱点，因为在Windows中的护斥对象仅对对当前用户生效。就是说如果用户User登陆了计算机Mathine1并运行了程序App1.在App1内部有互斥对象来防止程序被多次运行.故 User只能运行App1一次。这看起来像是正确的！并且App1的实例正在运行。稍后User2也登陆了计算机Mathine1并运行App1.当然了App1的互斥对象显然不会起到阻止程序运行的效果。程序正常运行并且创建了互斥。
这看起来似乎问题不大。虽然都是再同一计算机上，但是在不同的用户中运行的。

看看Windows的任务管理器，有个checkbox（显示所有用户的进程）
貌似我们也可以枚举系统进程看看我们的程序是否被运行了。因为你枚举进程的时候是枚举
的在此计算机上所有用户创建的进程，在程序的开始Main()判断进程中是否有该进程，如果有
就告知该系统已经运行或被其他用户运行了。

枚举进程的函数
创建进程快照句柄 handle = CreateToolHelp32SnapShot()
Process32First(handle, TProcessEntry32);
Process32Next(handle, TProcessEntry32);
最后别忘了CloseHandle(handle);释放缓存

//另一种变通的方法，通过列举系统中所有窗口（GetWindow）
function exe_is_running(const exeName:String) : Boolean; //exeName:不要扩展名的Exe主文件名
var
hCurrentWindow:HWnd;
szText:array[0..254] of char;
begin
Result := False;
hCurrentWindow:=Getwindow(Application.Handle,GW_HWNDFIRST);
while hCurrentWindow <> 0 do
begin
if Getwindowtext(hCurrentWindow,@sztext,255)>0 then
begin
if LowerCase(pchar(@sztext))=LowerCase(exeName) then
begin
Result := true;
Exit;
end;
end;
hCurrentWindow:=Getwindow(hCurrentwindow,GW_HWndNe

xt);
end;
end;