CreateMutex用法

CreateMutex

CreateMutex（）函数用来创建一个有名或无名的互斥量对象，其函数原型为：  
HANDLE CreateMutex(  
        LPSECURITY_ATTRIBUTES   lpMutexAttributes,        
        BOOL                bInitialOwner,         
        LPCTSTR         lpName           
);  

参数  

lpMutexAttributes      SECURITY_ATTRIBUTES，指定一个SECURITY_ATTRIBUTES结构，或传递零值（将参数声明为ByVal As Long，并传递零值），表示使用不允许继承的默认描述符  。

bInitialOwner     Long，初始化互斥对象的所有者。TRUE：占有，FALSE：不占有。 如希望立即占有该互斥量，则设为TRUE。 操作系统记录线程ID，将递归计数器设置为1，互斥量处于未触发/无信号/未通知状态。一个互斥体同时只能由一个线程拥有 。  为FALSE，则线程ID为NULL，操作系统将递归计数器设置为0，互斥量处于触发/有信号/已通知状态，不为任何线程所占用 。

lpName      String，指向互斥对象名的指针，设置互斥对象的名字。创建一个未命名的互斥体对象。如已经存在这个名字，则打开已命名互斥体 。有了名字就可以跨进程得到同一把锁。

返回值

Long，如执行成功，就返回互斥体对象的句柄，零表示出错。即使返回的是一个有效句柄，倘若指定的名字已经存在，GetLastError也会设为ERROR_ALREADY_EXISTS 。Long，如执行成功，就返回互斥体对象的句柄；零表示出错。会设置GetLastError。如果调用者限制了权限，GetLastError将会返回ERROR_ACCESS_DENIED 5，这个时候应该使用OpenMutex函数。

注意：  
不再需要时须用CloseHandle将互斥体句柄关闭。所有句柄都被关闭后，操作系统就会删除对象 ，进程中止前，一定要ReleaseMutex释放互斥体，如未释放，这个互斥体会被标记为废弃，并自动释放所有权。共享这个互斥体的其他应用程序，也许仍然能够用它，但会收到一个废弃状态信息，指出上一个拥有它的进程，未能正常关闭。这种状况是否会造成影响，取决于涉及到的应用程序。

创建一个互斥体（MUTEX）

CreateMutex，第二个参数为FALSE，创建者不占有Mutex，这时Mutex的状态是有信号的，所有的wait函数不等待直接返回。如果第二个参数为TRUE，表示创建者占有了Mutex，这时Mutex的状态是无信号的。其它线程中的wait函数将阻塞。 

也就是说如果你在第1个线程里执行 
hmutex=CreateMutex(NULL,TRUE,NULL);
而在另一个线程中执行 
WaitForSingleObject(hmutex,INFINITE);
如果第一个线程不ReleaseMutex()，第二个线程将一直被阻塞。

Windows的互斥锁Mutex是可以在进程间使用的，CreateMutex时可以指定一个mutex名称，此名称可以被其他进程或线程使用。CreateMutex的第二个参数BOOL bInitialOwner表示在创建后是不是立刻获取此锁，相当于立即WaitForSingleObject

HANDLE m_hMutex = CreateMutex(NULL,TRUE,"cplusplus_me");   只是创建了一把锁，还没有锁东西。

WaitForSingleObject(hMutex, INFINITE);  需要配合wait函数阻塞其他进程\线程

命名named mutex

HANDLE hNutex = CreateMutex(NULL, FALSE, L"eee"); //创建命名内核对象。 

创建本地命名对象和全局命名对象 
创建本地内核对象，在命名对象名字前面加Local。
创建全局对象，在命名对象前面加Global。

HANDLE hNutex = CreateMutex(NULL, FALSE, L"Local\\eee");  //创建本地内核对象 
HANDLE hNutex = CreateMutex(NULL, FALSE, L"Global\\eee");  //创建全局内核对象 

ReleaseMutex

解锁 ReleaseMutex(hMutex);

一个Mutex只有Create它的进程才可以Release它。ReleaseMutex只能由创建该Mutex的进程执行，不然总是返回错误。 进程通过OpenMutex得到的mutex是没有释放权的。

ReleaseMutex()让调用进程释放对该互斥体的拥有权，此时另一个在等待该mutex的线程，将得到信号停止等待（wait函数） 。

例如： 
WaitForSingleObject(hMutex,INFINITE);   hMutex对象如果变为激发状态，这个函数就会返回，继续往下执行 。

访问完共享资源以后应该释放对Mutex对象的拥有权，让其他要访问共享资源的线程拥有这个Mutex对象 。

副本HANDLE

在Mutex对象已存在时，使用CreateMutex和OpenMutex，结果一样都会返回一个副本HANDLE。
当该Muxtex不存在时，OpenMutex会返回0出错，并可用GetLastError得到错误信息。

CloseHandle(handle) 

关闭一个句柄，并将这个句柄的引用计数减一，如果句柄的引用计数减到0，那么操作系统将释放这个核心对象的句柄 。

用CloseHandle来释放Mutex时，只是释放当前进程获得的副本句柄，而不会删除该Mutex内核对象。

WaitForSingleObject函数

WaitForSingleObject函数用来检测hHandle事件的信号状态，当函数的执行 时间超过dwMilliseconds就返回，但如果参数dwMilliseconds为INFINITE 时函数将直到相应时间事件变成有信号状态才返回，否则就一直等待下去， 直到WaitForSingleObject有返回直才执行后面的代码。

hMutex=CreateMutex(NULL,TRUE,NULL);
当前线程调用该互斥对象次数为1，递归计数器设置为1

WaitForSingleObject(hMutex，INFINITE);
当前线程调用该互斥对象次数为2，递归计数器+1，为2

ReleaseMutex(hMutex);//释放占用互斥对象的线程的拥有权，递归计数器-1，递归计数器值为1 ReleaseMutex(hMutex);//释放占用互斥对象的线程的拥有权，递归计数器-1，递归计数器值为0

//递归计数器值为0，互斥对象处于触发/有信号/已通知状态，可以在此为其他线程所占用

基本的流程

WaitForSingleObject();   //等待取得互斥对象的拥有权，进而访问共享资源 

访问共享资源 

ReleaseMutex()    访问完共享资源后，当前进程线程释放Mutex(对象的拥有权 
CloseHandle();     关闭副本句柄

示例

bool func()
{
    HANDLE mutex;
    mutex = OpenMutex(MUTEX_ALL_ACCESS, FALSE, "namedmutex");
    if (mutex == NULL)
    {
        mutex = CreateMutex(NULL, FALSE, "namedmutex");
    }
    WaitForSingleObject(mutex, INFINITE);

    //功能区
    

    ReleaseMutex(mutex);
    return true;
}
 

测试代码：

int main()
{
    HANDLE hmutex = OpenMutex(MUTEX_ALL_ACCESS, FALSE, TEXT("namedmutex"));

//打开进程锁
    if (hmutex == NULL)
    {
        cout<<"Create Mutex"<<endl;
        hmutex = CreateMutex(NULL, false, TEXT("namedmutex"));//创建进程锁
    }
   WaitForSingleObject(hmutex, INFINITE);   //阻塞进程锁
 
    ReleaseMutex(hmutex);
    if (hmutex != NULL){
        CloseHandle(hmutex);
    }
    return 0;
}

禁止多开程序
int main(int argc, char* argv[])
{
    HANDLE m_hMutex = CreateMutex(NULL,TRUE,"testmutext");
    if (m_hMutex)
    {
        if (ERROR_ALREADY_EXISTS == GetLastError())
        {
            printf("程序已经在运行中了,程序退出!\n");
            CloseHandle(m_hMutex);
            return 0;
        }
    }
    else
    {
        printf("创建互斥量错误 退出!\n");
        CloseHandle(m_hMutex);
        return 0;
    }
    while(1)
    {
        printf("keeping  \n");  sleep(10);
    }
    CloseHandle(m_hMutex);
    return 0;
}