程序只启动一个实例的几种方法

我们在使用《金山词霸》时发现，在《金山词霸》已经运行了的情况下，再次点击《金山词霸》的图标，那么它不会再运行另外一个《金山词霸》，而是将已有的《金山词霸》给激活，始终只能运行一个《金山词霸》的实例。 
在我们的程序当中如果要实现类似《金山词霸》的功能，就要解决两个问题，首先是要判断该程序已有一个实例在运行，其次是要将已运行的应用程序实例激活，同时退出第二个应用程序实例。 
　　对于第一个问题，我们可以通过设置命名互斥对象或命名信标对象，在程序启动的时候检测互斥对象或信标对象，如互斥对象或信标对象已存在，则可以判断此程序已有一个实例正在运行。 
　　第二个问题是如何找到已经运行的应用程序实例，如果我们能够找到已运行实例主窗口的指针，即可调用SetForegroundWindow来激活该实例。我们可以通过两种形式找到已运行实例的主窗口，一种形式是通过调用FindWindowEx去查找正在运行的窗口的句柄，这种方式用得比较多一些，而本文通过另一种形式去查找正在运行的窗口的句柄。通过调用SetProp给应用程序主窗口设置一个标记，用GetDesktopWindow 可以获取Windows环境下的桌面窗口的句柄，所有应用程序的主窗口都可以看成该窗口的子窗口，接着我们就可以用GetWindow函数来获得这些窗口的句柄。然后再用Win32 SDK函数GetProp查找每一个应用程序的主窗口是否包含有我们设置的标记，这样就可以找到我们要找的第一个实例主窗口。 
下面演示代码是以一个单文档应用程序为例，工程名字是Mutex。 
1、在应用程序类InitInstance()函数中判断是否已有一个应用程序实例正在运行。 
BOOL CMutexApp::InitInstance() 
{ 
//创建命名信标对象。 
HANDLE hSem=CreateSemaphore(NULL,1,1,"维新"); 
if(hSem) //信标对象创建成功。 
{ 
//信标对象已经存在，则程序已有一个实例在运行。 
if(ERROR_ALREADY_EXISTS==GetLastError()) 
{ 
CloseHandle(hSem); //关闭信号量句柄。 

//获取桌面窗口的一个子窗口。 
HWND hWndPrev=::GetWindow(::GetDesktopWindow(),GW_CHILD); 

while(::IsWindow(hWndPrev)) 
{ 
//判断窗口是否有我们预先设置的标记，如有，则是我们寻找的窗口，并将它激活。 
if(::GetProp(hWndPrev,"维新")) 
{ 
//如果主窗口已最小化，则恢复其大小。 
if (::IsIconic(hWndPrev)) 
::ShowWindow(hWndPrev,SW_RESTORE); 

//将应用程序的主窗口激活。 
::SetForegroundWindow(hWndPrev); 
return FALSE; //退出实例。 
} 
//继续寻找下一个窗口。 
hWndPrev = ::GetWindow(hWndPrev,GW_HWNDNEXT); 
} 

AfxMessageBox("已有一个实例在运行，但找不到它的主窗口！"); 
} 
} 
else 
{ 
AfxMessageBox("创建信标对象失败，程序退出！"); 
return FALSE; 
} 

AfxEnableControlContainer(); 

// Standard initialization 
// If you are not using these features and wish to reduce the size 
// of your final executable, you should remove from the following 
// the specific initialization routines you do not need. 

#ifdef _AFXDLL 
Enable3dControls(); // Call this when using MFC in a shared DLL 
#else 
Enable3dControlsStatic(); // Call this when linking to MFC statically 
#endif 

// Change the registry key under which our settings are stored. 
// TODO: You should modify this string to be something appropriate 
// such as the name of your company or organization. 
SetRegistryKey(_T("Local AppWizard-Generated Applications")); 

LoadStdProfileSettings(); // Load standard INI file options (including MRU) 

// Register the application's document templates. Document templates 
// serve as the connection between documents, frame windows and views. 

CSingleDocTemplate* pDocTemplate; 
pDocTemplate = new CSingleDocTemplate( 
IDR_MAINFRAME, 
RUNTIME_CLASS(CMutexDoc), 
RUNTIME_CLASS(CMainFrame), // main SDI frame window 
RUNTIME_CLASS(CMutexView)); 
AddDocTemplate(pDocTemplate); 

// Parse command line for standard shell commands, DDE, file open 
CCommandLineInfo cmdInfo; 
ParseCommandLine(cmdInfo); 

// Dispatch commands specified on the command line 
if (!ProcessShellCommand(cmdInfo)) 
return FALSE; 

// The one and only window has been initialized, so show and update it. 
m_pMainWnd->ShowWindow(SW_SHOW); 
m_pMainWnd->UpdateWindow(); 

return TRUE; 
} 
2、在框架类的OnCreate()函数中设置查找标记。 
int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct) 
{ 
if (CFrameWnd::OnCreate(lpCreateStruct) == -1) 
return -1; 

if (!m_wndToolBar.CreateEx(this, TBSTYLE_FLAT, WS_CHILD | WS_VISIBLE | CBRS_TOP 
| CBRS_GRIPPER | CBRS_TOOLTIPS | CBRS_FLYBY | CBRS_SIZE_DYNAMIC) || 
!m_wndToolBar.LoadToolBar(IDR_MAINFRAME)) 
{ 
TRACE0("Failed to create toolbar "); 
return -1; // fail to create 
} 

if (!m_wndStatusBar.Create(this) || 
!m_wndStatusBar.SetIndicators(indicators, 
sizeof(indicators)/sizeof(UINT))) 
{ 
TRACE0("Failed to create status bar "); 
return -1; // fail to create 
} 

// TODO: Delete these three lines if you don't want the toolbar to 
// be dockable 

m_wndToolBar.EnableDocking(CBRS_ALIGN_ANY); 
EnableDocking(CBRS_ALIGN_ANY); 
DockControlBar(&m_wndToolBar); 


//设置查找标记。 
::SetProp(m_hWnd,"维新",(HANDLE)1); 

return 0; 
} 
3、在程序退出是删除设置的标记，在框架类中响应WM_DESTROY消息，进行处理。 
void CMainFrame::OnDestroy() 
{ 
CFrameWnd::OnDestroy(); 

// TODO: Add your message handler code here 
//删除所设置的标记。 
::RemoveProp(m_hWnd,"维新"); 
} 
至此，使应用程序只运行一个实例的功能就完成了。

 

 

程序只启动一个实例的几种方法

 

有些时候，我们要求一个程序在系统中只能启动一个实例。比如，Windows自带的播放软件Windows Medea Player在Windows里就只能启动一个实例。原因很简单，如果同时启动几个实例，却播放不同的文件，那么声音和图像就会引起混乱。在设计模式中，就有一个SINGLETON模式，该模式就是让类只有一个实例。（关于SINGLETON模式，可以看我那篇《重读《设计模式》之学习笔记（三）－－SINGLETON模式的疑惑 》）。
    对于程序而言，我们只有在程序启动的时候去检测某个设置，如果程序没有启动，就把设置更新为程序已经启动，然后正常启动程序；如果程序已经启动，那么就终止程序的启动。在程序退出的时候把设置恢复为程序没有启动。按照上面的思路，我们很容易就能想出下面的两种方法：
    一，文件法
    在硬盘上创建一个文件，在文件里设置一个值，根据这个值来判断程序是否已经启动。
    二，注册表法
    在注册表中创建一个键，根据该键的键值来决定是否要启动程序。
    但是，上面的两种方法，都有I/O操作。我觉得这不是最好的方法。下面就介绍两种不用I/O操作的方法。思路跟上面是一样的，在进程启动的时候去检测某个设置是否继续启动进程。由于要判断同一个程序是否已经启动一个实例，也就是说会有两个进程去访问同一个设置，所以该设置应该是可以夸进程访问的，比如上面两种方法中的文件和注册表。我们在用VC进行开发时，还可以用文件映射和互斥量。下面是详细的说明：
    VC在创建工程的时候，会自动创建一个App的类。比如，你的工程名是StarLee，那么这个App类的类名就是CStarLeeApp。在进程启动和退出的时候会分别调用该类的两个方法：InitInstance()和ExitInstance()。所以，我们的代码都是添加在这两个方法里面的。
    三，文件映射法
    首先，给App类加上一个成员变量： 

HANDLE m_hFileMapping;

    然后，在App类的InitInstance()方法的最前面加上下面的代码：

m_hFileMapping = CreateFileMapping(NULL, NULL, PAGE_READONLY, 0, 13, "StarLee");

// 检测是否已经创建FileMapping
// 如果已经创建，就终止进程的启动
if ((m_hFileMapping != NULL) && (GetLastError() == ERROR_ALREADY_EXISTS))
{
    CloseHandle(m_hFileMapping);
    
    MessageBox(NULL, "该进程已经启动", "错误", MB_OK);

    return FALSE;
}

    最后，在App类的ExitInstance()方法里加上下面的代码：

if (m_hFileMapping != NULL)
    CloseHandle(m_hFileMapping);

    四，互斥量法
    首先，给App类加上一个成员变量：

HANDLE m_hMutex;

    然后，在App类的InitInstance()方法的最前面加上下面的代码：

m_hMutex = CreateMutex(NULL, TRUE, "StarLee"); 

// 检测是否已经创建Mutex
// 如果已经创建，就终止进程的启动
if ((m_hMutex != NULL) && (GetLastError() == ERROR_ALREADY_EXISTS)) 
{
    ReleaseMutex(m_hMutex);

    MessageBox(NULL, "该进程已经启动", "错误", MB_OK);
 
    return FALSE;
}

    最后，在App类的ExitInstance()方法里加上下面的代码：

if (m_hMutex != NULL)
{
    ReleaseMutex(m_hMutex);
    CloseHandle(m_hMutex);
}

    上面两种方法的思路和代码添加的步骤都是一样的，当然效果也一样，选择任何一种方法都能达到让进程只启动一个实例的目的。