首页 > 代码库 > CreateMutex 【转】

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() 用于有独占要求的程序 (在其进程运行期间不允许其他使用此端口设备的程序运行,或不允许同名程序运行)。