CreateMutex
目录
编辑本段CreateMutex
作用
VB声明
Declare Function CreateMutex Lib "kernel32" Alias "CreateMutexA" (lpMutexAttributes As
SECURITY_ATTRIBUTES, ByVal bInitialOwner As Long, ByVal lpName As String) As Long
VC声明
HANDLE CreateMutex(
LPSECURITY_ATTRIBUTES
lpMutexAttributes, // 指向安全属性的指针
BOOL
bInitialOwner, // 初始化互斥对象的所有者
LPCTSTR
lpName // 指向互斥对象名的指针
);
编辑本段说明
创建一个
互斥体(MUTEX)
返回值
Long,如执行成功,就返回
互斥体对象的句柄;零表示出错。会设置GetLastError。即使返回的是一个有效句柄,但倘若指定的名字已经存在,GetLastError也会设为ERROR_ALREADY_EXISTS
参数表
参数 类型及说明
lpMutexAttributes SECURITY_ATTRIBUTES,指定一个SECURITY_ATTRIBUTES结构,或传递零值(将参数声明为ByVal As Long,并传递零值),表示使用不允许继承的默认描述符
lpName String,指定
互斥体对象的名字。用vbNullString创建一个
未命名的
互斥体对象。如已经存在拥有这个名字的一个事件,则打开现有的已命名
互斥体。这个名字可能不与现有的事件、信号机、可等待计时器或文件映射相符
编辑本段注解
一旦不再需要,注意必须用CloseHandle函数将
互斥体句柄关闭。从属于它的所有句柄都被关闭后,就会删除对象
进程中止前,一定要释放
互斥体,如不慎未采取这个措施,就会将这个互斥体标记为废弃,并自动释放所有权。共享这个互斥体的其他
应用程序也许仍然能够用它,但会接收到一个废弃状态信息,指出上一个所有进程未能正常关闭。这种状况是否会造成影响取决于涉及到的具体
应用程序
编辑本段使用例子:
常用操作mutex的函数还有:ReleaseMutex/OpenMutex/WaitForSingleObject/WaitForMultipleObjects。
创建互斥体
h_mutex1=CreateMutex(NULL,FALSE,"mutex_for_readcount");//创建一个互斥体
检查错误代码
#inlcude <stdio.h>
#include <windows.h>
...... // main function
HANDLE m_hMutex = CreateMutex(NULL, FALSE, "Sample07");// 检查错误代码
#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;
};
{
// 如果已有 互斥量存在则释放句柄并复位 互斥量
CloseHandle(m_hMutex);
m_hMutex = NULL;
// 程序退出
return FALSE;
};
CreateMutex() 用于有独占要求的程序 (在其进程运行期间不允许其他使用此端口设备的程序运行,或不允许同名程序运行)。