CreateMutex

CreateMutex

目录

CreateMutex

说明

注解

使用例子：

展开

CreateMutex

说明

注解

使用例子：

展开

编辑本段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，并传递零值），表示使用不允许继承的默认描述符

bInitialOwner Long，如创建进程希望立即拥有 互斥体，则设为TRUE。一个 互斥体同时只能由一个线程拥有

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");// 检查错误代码

if (GetLastError() == ERROR_ALREADY_EXISTS)
　{
　 // 如果已有 互斥量存在则释放句柄并复位 互斥量　
CloseHandle(m_hMutex);
　 m_hMutex = NULL;
　 // 程序退出
　 return FALSE;
　};

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

CreateMutex() 用于有独占要求的程序 (在其进程运行期间不允许其他使用此端口设备的程序运行，或不允许同名程序运行)。