CreateMutex

C++

API　CreateMutex

找出当前系统是否已经存在指定进程的实例。假设没有则创建一个相互排斥体。CreateMutex（）函数可用来创建一个有名或无名的相互排斥量对象。

HANDLE CreateMutex( 　　

LPSECURITY_ATTRIBUTES　lpMutexAttributes, // 指向安全属性的指针 　　

BOOL　bInitialOwner, // 初始化相互排斥对象的全部者 　　

LPCTSTR　lpName // 指向相互排斥对象名的指针 　　);

返回值 　　

Long，如运行成功，就返回相互排斥体对象的句柄；零表示出错。会设置GetLastError。

即使返回的是一个有效句柄，但倘若指定的名字已经存在，GetLastError也会设为ERROR_ALREADY_EXISTS

參数表 　　參数 类型及说明 　　

lpMutexAttributes SECURITY_ATTRIBUTES，指定一个SECURITY_ATTRIBUTES结构，或传递零值（将參数声明为ByVal As Long，并传递零值），

表示使用不同意继承的默认描写叙述符。

bInitialOwner BOOL，如创建进程希望马上拥有相互排斥体，则设为TRUE。一个相互排斥体同一时候仅仅能由一个线程拥有。是FALSE，表示刚刚创建的这个Mutex不属于不论什么线程


也就是没有不论什么线程拥有他，一个Mutex在没有不论什么线程拥有他的时候，他是处于激发态的， 所以处于有信号状态。

lpName String，指定相互排斥体对象的名字。用vbNullString创建一个未命名的相互排斥体对象。如已经存在拥有这个名字的一个事件，

则打开现有的已命名相互排斥体。这个名字可能不与现有的事件、信号机、可等待计时器或文件映射相符

该名称能够有一个"Global\" 或"Local\" 前缀，明白地建立在全局或会话命名空间的对象。剩余的名称能够包括不论什么字符，除反斜杠字符（\）。

使用终端服务（Terminal Services）会话，实现用户切换。内核对象名称必须遵循的指导方针，使应用程序能够支持多个用户终端服务。

typedef BOOL (CALLBACK* VERIFY_VERSION_INFO)

 (

 LPOSVERSIONINFOEX lpVersionInformation, 

 DWORD dwTypeMask, 

 DWORDLONG dwlConditionMask

 );

typedef ULONGLONG (CALLBACK* VER_SETCONDITION_MASK)(

 ULONGLONG dwlConditionMask,

 DWORD dwTypeBitMask,

 BYTE dwConditionMask

 );

bool IsValidTerminalService()

{

 bool result = FALSE;

 HINSTANCE hInst = LoadLibrary("Kernel32.Dll");

 if (hInst != NULL)

 {

  VERIFY_VERSION_INFO procVerifyVersionInfo = reinterpret_cast<VERIFY_VERSION_INFO>(::GetProcAddress(hInst, "VerifyVersionInfoA"));

  VER_SETCONDITION_MASK procVerSetConditionMask = reinterpret_cast<VER_SETCONDITION_MASK>(::GetProcAddress(hInst, "VerSetConditionMask"));

if (procVerifyVersionInfo != NULL && procVerSetConditionMask != NULL)

  {

   OSVERSIONINFOEX osVersionInfo;

   DWORDLONG dwlConditionMask = 0;

//(&osVersionInfo, sizeof(OSVERSIONINFOEX));

   osVersionInfo.dwOSVersionInfoSize = sizeof(OSVERSIONINFOEX);

   osVersionInfo.wSuiteMask = VER_SUITE_TERMINAL; // Terminal Services

dwlConditionMask = procVerSetConditionMask(dwlConditionMask, VER_SUITENAME, VER_AND);

   result = procVerifyVersionInfo(&osVersionInfo,VER_SUITENAME,dwlConditionMask);

}

  ::FreeLibrary(hInst);

 }

return result;

}

注意：

一旦不再须要，注意必须用CloseHandle函数将相互排斥体句柄关闭。从属于它的全部句柄都被关闭后，

就会删除对象 　　进程中止前，一定要释放相互排斥体，如不慎未採取这个措施，就会将这个相互排斥体标记为废弃，并自己主动释放全部权。

共享这个相互排斥体的其它应用程序或许仍然可以用它，但会接收到一个废弃状态信息，指出上一个全部进程未能正常关闭。这样的状况是否会造成影响取决于涉及到的详细应用程序

使用样例：

（1）、 h_mutex1=CreateMutex(NULL,FALSE,"mutex_for_readcount");//创建一个相互排斥体 　　

（2）、HANDLE m_hMutex = CreateMutex(NULL, FALSE, "Sample07");// 检查错误代码 　　

if (GetLastError() == ERROR_ALREADY_EXISTS) 　　

{ 　　

// 假设已有相互排斥量存在则释放句柄并复位相互排斥量 　　

CloseHandle(m_hMutex); 　　

m_hMutex = NULL; 　　// 程序退出 　　

return FALSE; 　　

}; 　　//上面这段代码演示了有名相互排斥量在进程相互排斥中的使用方法。代码的核心是CreateMutex（）对有名相互排斥量的创建。 　　

CreateMutex() 用于有独占要求的程序 (在其进程执行期间不同意其它使用此port设备的程序执行，或不同意同名程序执行)。