C++ 运行单一实例

运行单一实例

原理：通过CreateMutex函数创建一个命名互斥对象，并通过调用GetLastError函数获取CreateMutex函数返回码是否为 ERROR_ALREADY_EXISTS，是则返回true打印Already Run!!

CreateMutex函数

CreateMutex函数为创建或打开一个已命名或未命名的互斥对象

HANDLE WINAPI CreateMutex(
    _In_opt_ LPSECURITY_ATTRIBUTES lpMutexAttributes,
    _In_ BOOL bInitialOwner,
    _In_opt_LPCTSTR lpName)
    
_In_是一种标记宏，用于表示一个函数参数是输入参数

_In_opt_是一个预处理宏，用来指示lpMutexAttributes参数是一个可选参数，这个宏在函数调用中可以将该参数设置位NULL,表示该参数没有值或者不需要使用该参数提供的信息。如果没有使用_In_opt_，则表示该参数是必需的。
    
_In_ BOOL表示该函数有一个BOOL类型的输入参数，该参数的值会被函数使用，但不会被修改

_In_opt_LPCTSTR表示一个可选的以null结尾的字符串输入参数。调用者可以传递一个以null结尾的字符串作为该参数的值，也可以将该参数设置为NULL表示不使用该参数。如果函数需要该参数，则会使用传递的字符串值，否则会将该参数视为未指定。_In_opt_LPCTSTR在Unicode编译环境下，LPCTSTR被定义为const_wchar_t*，在ANSI编译环境下，LPCTSTR被定义为const char*。


    

CreateMutex函数使用的是Unicode字符集，CreateMutexA()函数使用的是ANSI字符集。其他参数，功能一样


句柄的本质上是一个指向内核对象的指针，但是它并不允许直接访问指向的内核对象。取而代之的是，必须使用Windows API提供的函数来操作内核对象。



HANDLE在Windows api中定义的一种通用句柄类型，用来表示各种对象的句柄。句柄在Windows中是一种与实际对象无关的抽象引用，可以使用句柄访问，控制和操作各种系统对象，例如文件，进程，互斥体，事件，信号量等等。
    
HANDL的类型的值是一个32位或者64位的无符号整数，可以用来唯一的标识一个系统对象，在使用WINDOWS API函数的时候，通过需要传递对象的句柄作为参数。函数可以通过句柄来访问对象，对对象进行读取，写入，启动或停止对象的进程等等。  
 
函数返回的句柄通常需要保存起来，以便后续使用和关闭。我们可以使用 CloseHandle()函数来关闭一个句柄，并释放相关的系统资源。

实例代码

#include <Windows.h>
#include <stdio.h>
//#include <tchar.h> 预处理器定义的宏
#include <tchar.h>

BOOL IsAlreadyRun() {
	HANDLE hMutex = NULL;
	hMutex = ::CreateMutex(NULL, FALSE, L"TEST");
	if (hMutex) {
//GetLastError()函数最近的win32 api函数时被调用打印的消息
        //CreateMutex()函数，在存在命名互斥对象时会返回ERROR_ALREADY_EXISTS
        //当存在命令互斥对象时，返回TRUE，打印Already Run!!
		if (ERROR_ALREADY_EXISTS == ::GetLastError())
		{
			return TRUE;
		}
	}
	return FALSE;
}

//_tmain windows 宽字节版main函数入口
//_TCHAR是一个宏定义
//arg[] 是一个指向TCHAR类型的指针数组
int _tmain(int argc, _TCHAR* arg[]) {
	if (IsAlreadyRun())
	{
		printf("Already Run!!\n");
	}
	else
	{
		printf("NOT Already Run!\n");
	}
    //暂停程序的输出直到用户按下任意键
	system("pause");
	return 0;
}