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

最新推荐文章于 2023-07-11 14:22:42 发布

na_he

最新推荐文章于 2023-07-11 14:22:42 发布

阅读量2.5k

点赞数

文章标签： null initialization application mfc windows 金山

本文链接：https://blog.csdn.net/na_he/article/details/2482657

版权

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

Findwindow的方法

一、实现方法

　　对于具有窗口的应用程序，可以用静态函数CWnd::FindWindow()查找固定窗口，来判断程序是否已经运行。函数原型为：

CWnd* PASCAL FindWindow( LPCTSTR lpszClassName, LPCTSTR lpszWindowName );

　　这个函数有两个参数，第一个是要找的窗口的类，第二个是要找的窗口的标题。在搜索的时候不一定两者都知道，但至少要知道其中的一个。有的窗口的标题是比较容易得到的，如"计算器"，所以搜索时应使用标题进行搜索。但有的软件的标题不是固定的，如"记事本"，如果打开的文件不同，窗口标题也不同，这时使用窗口类搜索就比较方便。如果找到了满足条件的窗口，这个函数返回该窗口的指针，否则返回值为NULL。

　　考虑到程序的健壮性，我们还需要判断窗口是否处于最小化状态、是否有弹出式子窗口，这就需要使用CWnd:: GetLastActivePopup()、CWnd::IsIconic()函数，它们的原型分别为：

CWnd* GetLastActivePopup( )

　　该函数返回一个指定父窗口中最近激活过的弹出式窗口的指针。如果窗口本身是刚刚激活的，或窗口不包含任何弹出窗口，那么该函数返回指向父窗口自身的指针。

BOOL IsIconic( )

　　该函数用来判断当前窗口是否处于最小化状态，如果窗口处于最小化状态，函数返回值为True，否则返回Flase。

　　对于处于最小化状态的窗口，可以调用CWnd::ShowWindow( int nCmdShow )恢复窗口的正常状态，该函数的原型为：

BOOL ShowWindow( int nCmdShow )

　　如窗口之前是可见的，函数调用后返回True，否则返回False。参数nCmdShow的值可以为以下任意个常数：

　　 SW_HIDE：隐藏窗口，活动状态给令一个窗口;

　　 SW_MINIMIZE：最小化窗口，活动状态给另一个窗口;

　　 SW_RESTORE：用原来的大小和位置显示一个窗口，同时令其进入活动状态;

　　 SW_SHOW：用当前的大小和位置显示一个窗口，同时令其进入活动状态;

　　 SW_SHOWMAXIMIZED：最大化窗口，并将其激活;

　　 SW_SHOWMINIMIZED：最小化窗口，并将其激活;

　　 SW_SHOWMINNOACTIVE：最小化一个窗口，同时不改变活动窗口;

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

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

　　 SW_SHOWNORMAL：与SW_RESTORE相同;

　　最后不要忘记了用CWnd:: SetForegroundWindow()函数将弹出窗口设置为桌面的最前端。

　　有了上面的知识，我们就可以修改程序中应用程序类的InitInstance()函数，如果程序已经运行，也即是可以发现相应的程序窗口，那么就显示该窗口，InitInstance()函数就返回False，程序提前退出，否则就正常运行。

　　 二、编程步骤

　　 1、启动Visual C++6.0，生成一个基于对话框的应用程序，程序命名为"Instance";

　　 2、修改程序的InitInstance()函数;

　　 3、添加代码，编译运行程序;

　　三、程序代码

/
// CInstanceApp initialization
BOOL CInstanceApp::InitInstance()
{
　 if (!FirstInstance())
　　 return FALSE;
　 AfxEnableControlContainer();
　 #ifdef _AFXDLL
　　 Enable3dControls(); // Call this when using MFC in a shared DLL
　 #else
　　 Enable3dControlsStatic(); // Call this when linking to MFC statically
　 #endif
　 CInstanceDlg dlg;
　 m_pMainWnd = &dlg;
　 int nResponse = dlg.DoModal();
　 if (nResponse == IDOK)
　 {
　　 // TODO: Place code here to handle when the dialog is
　　 // dismissed with OK
　 }
　 else if (nResponse == IDCANCEL)
　 {
　　 // TODO: Place code here to handle when the dialog is
　　 // dismissed with Cancel
　 }
　 // Since the dialog has been closed, return FALSE so that we exit the
　 // application, rather than start the application's message pump.
　 return FALSE;
}

BOOL CInstanceApp::FirstInstance()
{
　 CWnd *pWndPrev, *pWndChild;

　 // Determine if another window with our class name and Window title exists...
　 // The title "Instance " is set up latter, in the InitDialog function.
　 if (pWndPrev = CWnd::FindWindow(NULL, "Instance "))
　 {
　　 pWndChild = pWndPrev- >GetLastActivePopup();
　　 // if so, does it have any popups?
　　 if (pWndPrev- >IsIconic())
　　　 pWndPrev- >ShowWindow(SW_RESTORE);
　　　 // If iconic, restore the main window
　　　 pWndChild- >SetForegroundWindow();
　　　 // Bring the window to the foreground
　　 return FALSE;
　 }
　 else
　　 return TRUE; // First instance. Proceed as normal.
}