vc 只运行一个实例,并激活已运行实例

原文地址 ：http://blog.chinaunix.net/u1/37538/showart_375262.html

 

进程的互斥运行：CreateMutex函数实现只运行一个程序实例

　　正常情况下，一个进程的运行一般是不会影响到其他正在运行的进程的。但是对于某些有特殊要求的如以独占方式使用串行口等硬件设备的程序就要求在 其进程运行期间不允许其他试图使用此端口设备的程序运行的，而且此类程序通常也不允许运行同一个程序的多个实例。这就引出了进程互斥的问题。

　　实现进程互斥的核心思想比较简单：进程在启动时首先检查当前系统是否已经存在有此进程的实例，如果没有，进程将成功创建并设置标识实例已经存在 的标记。此后再创建进程时将会通过该标记而知晓其实例已经存在，从而保证进程在系统中只能存在一个实例。具体可以采取内存映射文件、有名事件量、有名互斥 量以及全局共享变量等多种方法来实现。下面就分别对其中具有代表性的有名互斥量和全局共享变量这两种方法进行介绍：

// 创建互斥量
HANDLE m_hMutex = CreateMutex(NULL, FALSE, "Sample07");
// 检查错误代码

// 如果程序已经存在并且正在运行
if (GetLastError() == ERROR_ALREADY_EXISTS)

{
// 如果已有互斥量存在则释放句柄并复位互斥量
　 CloseHandle(m_hMutex);
　 m_hMutex = NULL;
　 // 程序退出
　 return FALSE;
}

 

 

我们在使用《金山词霸》时发现，在《金山词霸》已经运行了的情况下，再次点击《金山词霸》的图标，那么它不会再运行另外一个《金山词霸》，而是将已有的《金山词霸》给激活，始终只能运行一个《金山词霸》的实例。
在我们的程序当中如果要实现类似《金山词霸》的功能，就要解决两个问题，首先是要判断该程序已有一个实例在运行，其次是要将已运行的应用程序实例激活，同时退出第二个应用程序实例。
　　对于第一个问题，我们可以通过设置命名互斥对象或命名信标对象，在程序启动的时候检测互斥对象或信标对象，如互斥对象或信标对象已存在，则可以判断此程序已有一个实例正在运行。
　 　第二个问题是如何找到已经运行的应用程序实例，如果我们能够找到已运行实例主窗口的指针，即可调用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/n");
return -1; // fail to create
}

if (!m_wndStatusBar.Create(this) ||
!m_wndStatusBar.SetIndicators(indicators,
sizeof(indicators)/sizeof(UINT)))
{
TRACE0("Failed to create status bar/n");
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);
}

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