Win32单实例应用程序实现

　　开发者还能够注意到，在Win16和Win32之间的另一种差别是，所有的Win32应用程序都是以单实例方式来运行的，甚至当该应用程序的另一个实例正在运行之中也是如此。这是因为在Win32环境下，所有的应用程序都有一个单独的地址空间。结果，传递给一个应用程序的WinMain过程的hPrevInstance参数将总是为NULL。

　　一般来说，这会给应用程序的开发者带来方便。在Win16下，开发者不得不清楚的知道是否必须运行某个应用程序的多个实例，并且当这些实例共享该应用程序的代码段时，要提前报警以确保该应用程序能够正常地工作。在Win32下，开发者则不需要担心多实例的问题。也不用为了确保应用程序的正常运行而提前报警。

　　实际上，上面的论述并不是完全正确的。对于USER32或GDI32来说，内存访问就不需要提前报警，但是开发者仍然需要注意它。例如，如果该应用程序访问一个数据文件，开发者必须确保该应用程序的两个实例能够同时的或顺序的访问该文件。为了避免这种情况发生，开发者可以使用FindWindow函数，以确保同一时间该应用程序只有一个实例在运行：

if (hWndApp = FindWindow(szAppMainWindowClassName, NULL)) {

hWndPopup = GetLastActivePopup(hWndApp);

BringWindowToTop(hWndApp);

if ( IsIconic(hWndPopup) )

ShowWindow(hWndPopup, SW_RESTORE);

else

SetForegroundWindow(hWndPopup);

return FALSE;

}

　　对于Win32的应用程序来说，它工作正常，但是对于Windows NT，则带来了另外的问题。在Windows NT中，一个应用程序可以被加载多次，并且时间间隔可以非常小。例如，如果您使用"启动"命令从批处理文件启动一个应用程序，Windows NT将一个接一个的启动这些进程，但是其中的进程启动的速度是非常快的，它的前一个进程还没有完成初始化工作。在这种情况下，FindWindow函数将找不到该窗口类的另一个实例，而该应用程序的另一个实例是确实存在的。为了避免这种情况，该应用程序必须使用一个WIN32同步对象，例如Mutex，代码如下：

hMutex = CreateMutex(NULL, FALSE, "ThreadSampleMutex" );

if ( WaitForSingleObject(hMutex, 10000) == WAIT_TIMEOUT ) {

//

// 有另一个实例，但是定位它花费的时间太长，

// 退出。

return FALSE;

}

if (hWndApp = FindWindow(szAppMainWindowClassName, NULL)) {

hWndPopup = GetLastActivePopup(hWndApp);

BringWindowToTop(hWndApp);

if ( IsIconic(hWndPopup) )

ShowWindow(hWndPopup, SW_RESTORE);

else

SetForegroundWindow(hWndPopup);

ReleaseMutex(hMutex);

CloseHandle(hMutex);

return FALSE;

}

if (!Init(hInstance, cmdShow)) {

ReleaseMutex(hMutex);

CloseHandle(hMutex);

return 1;

}

ReleaseMutex(hMutex);

CloseHandle(hMutex);

异步输入队列

　　USER32最优秀的功能之一是它的输入处理模式。但是不幸的是，这种功能目前仅在Windows NT下可用。
使应用程序只能运行一个实例
Windows是多进程操作系统，框架生成的应用程序可以多次运行，形成多个运行实例。但在有些情况下为保证应用程序的安全运行，要求程序只能运行一个实例，比如程序要使用只能被一个进程单独使用的特殊硬件（例如调制解调器）时，必须限制程序只运行一个实例。
这里涉及两个基本的问题，一是在程序的第二个实例启动时，如何发现该程序已有一个实例在运行，而是如何将第一个实例激活，而第二个实例退出。
对于第一个问题，可以通过给应用程序设置信号量，实例启动时首先检测该信号量，如已存在，则说明程序已运行一个实例。
第二个问题的难点是获取第一个实例的主窗对象指针或句柄，然后便可用SetForegroundWindow来激活。虽然FindWindow函数能寻找正运行着的窗口，但该函数要求指明所寻找窗口的标题或窗口类名，不是实现通用方法的途径。我们可以用Win 32 SDK函数SetProp来给应用程序主窗设置一个特有的标记。用GetDesktopWindow可以获取Windows系统主控窗口对象指针或句柄，所有应用程序主窗都可看成该窗口的子窗口，即可用GetWindow函数来获得它们的对象指针或句柄。用Win 32 SDK函数GetProp查找每一应用程序主窗是否包含有我们设置的特定标记便可确定它是否我们要寻找的第一个实例主窗。使第二个实例退出很简单，只要让其应用程序对象的InitInstance函数返回FALSE即可。此外，当主窗口退出时，应用RemoveProp函数删除我们为其设置的标记。
下面的InitInstance、OnCreate和OnDestroy函数代码将实现上述的操作：
BOOL CEllipseWndApp::InitInstance()
{
// 用应用程序名创建信号量
HANDLE hSem = CreateSemaphore(NULL, 1, 1, m_pszExeName);

// 信号量已存在？
// 信号量存在，则程序已有一个实例运行
if (GetLastError() == ERROR_ALREADY_EXISTS)
{
// 关闭信号量句柄
CloseHandle(hSem);

// 寻找先前实例的主窗口
HWND hWndPrevious = ::GetWindow(::GetDesktopWindow(),
GW_CHILD);
while (::IsWindow(hWndPrevious))
{
// 检查窗口是否有预设的标记?
// 有，则是我们寻找的主窗
if (::GetProp(hWndPrevious, m_pszExeName))
{
// 主窗口已最小化，则恢复其大小
if (::IsIconic(hWndPrevious))
::ShowWindow(hWndPrevious,
SW_RESTORE);
// 将主窗激活
::SetForegroundWindow(hWndPrevious);
// 将主窗的对话框激活
::SetForegroundWindow(
::GetLastActivePopup(hWndPrevious));

// 退出本实例
return FALSE;
}

// 继续寻找下一个窗口
hWndPrevious = ::GetWindow(hWndPrevious,
GW_HWNDNEXT);
}

// 前一实例已存在，但找不到其主窗
// 可能出错了
// 退出本实例
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

CEllipseWndDlg 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;
}

int CEllipseWndDlg::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
if (CDialog::OnCreate(lpCreateStruct) == -1)
return -1;

// 设置寻找标记
::SetProp(m_hWnd, AfxGetApp()->m_pszExeName, (HANDLE)1);

return 0;
}

void CEllipseWndDlg::OnDestroy()
{
CDialog::OnDestroy();

// 删除寻找标记
::RemoveProp(m_hWnd, AfxGetApp()->m_pszExeName);
}

Technorati : Win32单实例