• 1.摘要
  • 2.基本信息
  • 3.定义简介
  • 3.1.VB声明
  • 3.2.VC声明
  • 4.说明
  • 5.注解
  • 6.使用例子
  • 6.1.创建互斥体
  • 6.2.检查错误代码
  • 6.3.详细例子
  • 7.参考资料

CreateMutex

CreateMutex是一个计算机函数,作用是找出当前系统是否已经存在指定进程的实例。如果没有则创建一个互斥体。

基本信息

  • 中文名称

    CreateMutex

  • 外文名称

    CreateMutex

  • 解释

    创建一个互斥体

  • 学科

    计算机学

定义简介

CreateMutex()函数可用来创建一个有名或无名的互斥量对象,其函数原型为:

VB声明

Declare Function CreateMutex Lib "kernel32" Alias "CreateMutexA" (lpMutexAttributes AsSECURITY_ATTRIBUTES, ByVal bInitialOwner As Long, ByVal lpName As String) As Long

VC声明

HANDLE CreateMutex(

LPSECURITY_ATTRIBUTESlpMutexAttributes, // 指向安全属性的指针

BOOLbInitialOwner, // 初始化互斥对象的所有者

LPCTSTRlpName// 指向互斥对象名的指针

);

说明

创建一个互斥体(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创建一个未命名的互斥体对象。如已经存在拥有这个名字的一个事件,则打开现有的已命名互斥体。这个名字可能不与现有的事件、信号机、可等待计时器或文件映射相符