-
CreateMutex
鎖定
- 中文名
- CreateMutex
- 外文名
- CreateMutex
- 解 釋
- 創建一個互斥體
- 學 科
- 計算機學
CreateMutex定義簡介
CreateMutex()函數可用來創建一個有名或無名的互斥量對象，其函數原型為：
CreateMutexVB聲明
Declare Function CreateMutex Lib "kernel32" Alias "CreateMutexA" (lpMutexAttributes As SECURITY_ATTRIBUTES, ByVal bInitialOwner As Long, ByVal lpName As String) As Long
CreateMutexVC聲明
HANDLE CreateMutex( LPSECURITY_ATTRIBUTESlpMutexAttributes, // 指向安全屬性的指針 BOOLbInitialOwner, // 初始化互斥對象的所有者 LPCTSTRlpName // 指向互斥對象名的指針 );
CreateMutex説明
創建一個互斥體（MUTEX）
返回值
Long，如執行成功，就返回互斥體對象的句柄；零表示出錯。會設置GetLastError。如果返回的是一個有效句柄，但指定的名字已經存在，GetLastError也會設為ERROR_ALREADY_EXISTS，bInitialOwner的值將會被忽略。如果調用者限制了權限，GetLastError將會返回ERROR_ACCESS_DENIED，這個時候應該使用OpenMutex函數。
參數表
參數 類型及説明
lpMutexAttributes SECURITY_ATTRIBUTES，指定一個SECURITY_ATTRIBUTES結構，或傳遞零值（將參數聲明為ByVal As Long，並傳遞零值），表示使用不允許繼承的默認描述符
bInitialOwner BOOL，如創建進程希望立即擁有互斥體，則設為TRUE。一個互斥體同時只能由一個線程擁有
lpName String，指定互斥體對象的名字。用vbNullString創建一個未命名的互斥體對象。如已經存在擁有這個名字的一個事件，則打開現有的已命名互斥體。這個名字可能不與現有的事件、信號機、可等待計時器或文件映射相符
CreateMutex註解
一旦不再需要，注意必須用CloseHandle函數將互斥體句柄關閉。從屬於它的所有句柄都被關閉後，就會刪除對象
線程中止前，一定要調用ReleaseMutex釋放互斥體，如不慎未採取這個措施，就會將這個互斥體標記為廢棄（下一個釋放的等待函數會返回WAIT_ABANDONED），並自動釋放所有權。共享這個互斥體的其他應用程序也許仍然能夠用它，但會接收到一個廢棄狀態信息，指出上一個所有進程未能正常關閉。這種狀況是否會造成影響取決於涉及到的具體應用程序。
在Windows系統中，線程可以在等待函數中指定一個此線程已經擁有的互斥體，由於Windows的防死鎖機制，這種做法不會阻止此線程的運行。
CreateMutex使用例子
常用操作mutex的函數還有：ReleaseMutex/OpenMutex/WaitForSingleObject/WaitForMultipleObjects。
CreateMutex創建互斥體
h_mutex1=CreateMutex(NULL,FALSE,"mutex_for_readcount");//創建一個互斥體
CreateMutex檢查錯誤代碼
#include <stdio.h>
#include <windows.h>
...... // main function
HANDLE m_hMutex = CreateMutex(NULL, FALSE, "Sample07");// 檢查錯誤代碼
if (GetLastError() == ERROR_ALREADY_EXISTS)
{
// 如果已有互斥量存在則釋放句柄並復位互斥量
CloseHandle(m_hMutex);
m_hMutex = NULL;
// 程序退出
return FALSE;
};
//上面這段代碼演示了有名互斥量在進程互斥中的用法。代碼的核心是CreateMutex（）對有名互斥量的創建。
CreateMutex() 用於有獨佔要求的程序 (在其進程運行期間不允許其他使用此端口設備的程序運行，或不允許同名程序運行)。
CreateMutex詳細例子
#include "stdafx.h"
#include "windows.h"
int main(int argc, char* argv[])
{
HANDLE m_hMutex = CreateMutex(NULL,TRUE,"cplusplus_me");
DWORD dwRet = GetLastError();
if (m_hMutex)
{
if (ERROR_ALREADY_EXISTS == dwRet)
{
printf("程序已經在運行中了,程序退出!\n");
CloseHandle(m_hMutex);
return 0;
}
}
else
{
printf("創建互斥量錯誤,程序退出!\n");
CloseHandle(m_hMutex);
return 0;
}
while(1)
{
printf("cplusplus_me\n");
}
CloseHandle(m_hMutex);
return 0;
}
- 參考資料
-
- 1. CreateMutex函數 ．C/C++程序員之家．2015-01-01[引用日期2015-03-03]
