如果應用程序的另一個實例影響到可選(非首要)功能,應用程序啟動時必須:
1)檢測是否有用戶正在運行該應用程序。
2)阻止所有有問題的功能。
3)通知當前用戶無法使用特定功能的原因。
如果應用程序的另一個實例影響首要功能,同樣,您的應用程序必須:
1)檢測是否有用戶正在運行該應用程序。
2)向當前用戶報告錯誤情況,然后退出。
下面給出一個實例:
創建 Win32 應用程序
啟動 Visual Studio 并新建一個名為 FastUserSwitching 的 Win32 應用程序。
Visual C++ 6.0 用戶: 從可用項目類型列表中選擇 Win32 應用程序,然后在應用程序安裝向導中選擇一個典型的“Hello World”應用程序。
Visual Studio .NET 用戶: 在 Visual C++ 項目中選擇 Win32 項目并接受應用程序安裝向導中顯示的默認應用程序設置。
添加接收會話切換通知的代碼
如果你的應用程序需要知道何時要在活動用戶會話中運行以及何時發生了會話切換,該應用程序可以通過調用 WTSRegisterSessionNotification 函數進行注冊以接收 WM_WTSSESSION_CHANGE 消息:
1、打開 stdafx.h 并在包含 windows.h 的語句之前添加以下 #define 語句:
#define _WIN32_WINNT 0x0501
這是 winuser.h 的要求,其目的是定義通知類型和宏。
2、在 FastUserSwitching.cpp 的頂部包含以下頭文件(其中包含 WTSRegisterSessionNotification 函數原型):
#include <wtsapi32.h>
3、將 Wtsapi32.lib 添加到項目的庫列表。
4、在 FastUserSwitching.cpp 中找到 InitInstance 函數。在函數的尾部的 return 語句之前,添加對 WTSRegisterSessionNotification 的調用,如下所示:
WTSRegisterSessionNotification(hWnd, NOTIFY_FOR_THIS_SESSION);
5、找到 WndProc 窗口過程并添加處理 WM_WTSSESSION_CHANGE 消息的 case 語句。 此消息的 wParam 包含狀態編碼,表明發出會話更改通知的原因。 添加以下代碼檢測可用狀態編碼的子集并顯示消息框,表明已收到哪些狀態編碼:

code
1
case WM_WTSSESSION_CHANGE:
2
switch( wParam )
3
{
4
case WTS_CONSOLE_CONNECT:
5
MessageBox(hWnd, TEXT("WTS_CONSOLE_CONNECT"),
6
TEXT("WM_WTSSESSION_CHANGE"), MB_OK );
7
break;
8
case WTS_CONSOLE_DISCONNECT:
9
MessageBox(hWnd, TEXT("WTS_CONSOLE_DISCONNECT"),
10
TEXT("WM_WTSSESSION_CHANGE"), MB_OK );
11
break;
12
case WTS_SESSION_LOCK:
13
MessageBox(hWnd, TEXT("WTS_SESSION_LOCK"),
14
TEXT("WM_WTSSESSION_CHANGE"), MB_OK );
15
break;
16
case WTS_SESSION_UNLOCK:
17
MessageBox(hWnd, TEXT("WTS_SESSION_UNLOCK"),
18
TEXT("WM_WTSSESSION_CHANGE"), MB_OK );
19
break;
20
default:
21
break;
22
}
23
break;
24
6、每一個對 WTSRegisterSessionNotification 的調用應與一個對 WTSUnRegisterSessionNotification 的調用匹配。 在 WndProc 中修改 WM_DESTROY 消息的處理,如下所示:
case WM_DESTROY:
WTSUnRegisterSessionNotification(hWnd);
PostQuitMessage(0);
break;
確認會話切換通知
本任務假定至少有兩個用戶帳戶。 如果您只有一個帳戶,請再新建一個帳戶。
1、重新生成項目。
2、運行該應用程序。
3、從開始菜單中,單擊注銷,然后單擊切換用戶。
4、單擊當前用戶名返回到前一個用戶會話。
5、確認您已經收到 WTS_SESSION_LOCK 和 WTS_SESSION_UNLOCK 通知。
6、單擊確定可消除這兩個消息框。
7、從開始菜單中,單擊注銷,然后單擊切換用戶。
8、切換到新用戶會話,然后再切換回原來的用戶會話。
9、確認您已經收到 WTS_SESSION_LOCK、WTS_CONSOLE_DISCONNECT、WTS_SESSION_UNLOCK 和 WTS_CONSOLE_CONNECT 通知。
10、單擊確定可消除所有消息框。
11、關閉應用程序。
檢測現有應用程序實例
若要檢測現有的應用程序實例,使用一個全局 mutex 或 semaphore 對象(名稱已知)。在對象名前添加前綴“Global\”確保使用全局命名空間。這樣就可以檢測在不同用戶會話環境中運行的您的應用程序實例。
使用 FindWindow 或 FindWindowEx 的傳統方法在啟用快速用戶切換的 Windows XP 系統中不起作用,因為這些方法不會檢測在不同用戶會話環境中(或不同桌面)運行的應用程序實例。
1、編輯 FastUserSwitching.cpp。
2、在文件頂部的現有全局變量后聲明并初始化一個全局變量,存儲 mutex 對象的句柄。
HANDLE g_hMutexAppRunning = NULL;
3、為新建函數添加以下函數原型,檢測應用程序實例是否已存在:
BOOL AppInstanceExists();
4、在源文件的末尾,使用以下代碼創建 AppInstanceExists 函數。 此代碼試圖創建一個全局 mutex 對象,然后檢查是否創建并打開了 mutex 對象(通過檢查錯誤代碼 ERROR_ALREADY_EXISTS 實現)。 在這種情況下,錯誤代碼表明已有應用程序實例運行。 如果是這樣,代碼關閉 mutex 對象并返回“TRUE”。 如果此函數成功創建了一個新的 mutex 對象,將返回“FALSE”,表明這是第一個應用程序實例。

code
1
BOOL AppInstanceExists()
2

{
3
BOOL bAppRunning = FALSE;
4
// Create a global mutex. Use a unique name, for example
5
// incorporating your company and application name.
6
g_hMutexAppRunning = CreateMutex( NULL, FALSE, "Global\\My MpApp.EXE");
7
// Check if the mutex object already exists, indicating an
8
// existing application instance
9
if (( g_hMutexAppRunning != NULL ) &&
10
( GetLastError() == ERROR_ALREADY_EXISTS))
11
{
12
// Close the mutex for this application instance. This assumes
13
// the application will inform the user that it is
14
// about to terminate
15
CloseHandle( g_hMutexAppRunning );
16
g_hMutexAppRunning = NULL;
17
}
18
// Return False if a new mutex was created,
19
// as this means it's the first app instance
20
return ( g_hMutexAppRunning == NULL );
21
}
5、您必須確保當運行的應用程序終止時,mutex 對象關閉。 將以下代碼添加到 WinMain 函數的末尾,位于消息循環之后,最后的 return 語句之前:
if (g_hMutexAppRunning != NULL )
{
CloseHandle(g_hMutexAppRunning);
g_hMutexAppRunning = NULL;
}
將現有應用程序實例設置到前臺
如果只允許運行應用程序的一個實例,您應當使用 FindWindow 和 SetForegroundWindow API 在后續實例啟動時將現有實例置于前臺(如果現有實例運行在當前用戶會話中)。 您必須測試 FindWindow 的返回值,因為如果現有應用程序實例在另一個用戶的會話中運行,將返回 NULL。
找到 InitInstance 函數進行修改,如下所示:

code
1
BOOL InitInstance(HINSTANCE hInstance, int nCmdShow)
2
{
3
HWND hWnd;
4
hInst = hInstance;
5
// Check if another application instance is already running
6
if ( AppInstanceExists() == TRUE )
7
{
8
HWND hWndOtherInstance;
9
hWndOtherInstance = FindWindow(szWindowClass, szTitle);
10
if ( hWndOtherInstance != (HWND)NULL )
11
{
12
// Application is running in current user's session
13
if ( IsIconic(hWndOtherInstance) )
14
ShowWindow(hWndOtherInstance, SW_RESTORE);
15
SetForegroundWindow(hWndOtherInstance);
16
}
17
else
18
{
19
MessageBox(NULL, TEXT("An instance of this app is running in another user's session"), szTitle, MB_OK);
20
}
21
return FALSE;
22
}
23
hWnd = CreateWindow(szWindowClass, szTitle, WS_OVERLAPPEDWINDOW,
24
CW_USEDEFAULT, , CW_USEDEFAULT, , NULL, NULL,
25
hInstance, NULL );
26
if (!hWnd)
27
return FALSE;
28
29
ShowWindow(hWnd, nCmdShow);
30
UpdateWindow(hWnd);
31
WTSRegisterSessionNotification(hWnd, NOTIFY_FOR_THIS_SESSION);
32
return TRUE;
33
}
測試應用程序檢測
1、生成項目。
2、運行該應用程序。
3、最小化應用程序。
4、啟動應用程序的另一個實例,檢查現有應用程序是否被恢復并置于前臺。
5、反復啟動其他的啟動應用程序實例,并確保每次啟動時現有應用程序都置于前臺。
6、在應用程序的一個實例運行時,切換到新的用戶會話。
7、試圖啟動應用程序,您會看到一個消息框,它說明了該應用程序已在另一個用戶會話中運行。
8、單擊確定消除此消息框。
9、返回到原來的用戶會話,關閉會話切換通知消息窗口并退出應用程序