openMutexW 函数 (synchapi.h)

项目
08/26/2023

打开现有的命名互斥对象。

语法

HANDLE OpenMutexW(
  [in] DWORD   dwDesiredAccess,
  [in] BOOL    bInheritHandle,
  [in] LPCWSTR lpName
);

参数

[in] dwDesiredAccess

对互斥对象的访问。只有 SYNCHRONIZE 访问权限才需要使用互斥体;若要更改互斥体的安全性，请指定 MUTEX_ALL_ACCESS。如果指定对象的安全描述符不允许对调用进程进行请求的访问，则函数将失败。有关访问权限的列表，请参阅 Synchronization Object Security and Access Rights。

[in] bInheritHandle

如果此值为 TRUE，则此进程创建的进程将继承句柄。否则，进程不会继承此句柄。

[in] lpName

要打开的互斥体的名称。名称比较区分大小写。

此函数可以打开专用命名空间中的对象。有关详细信息，请参阅对象命名空间。

终端服务： 名称可以具有“Global”或“Local”前缀，以显式打开全局命名空间或会话命名空间中的对象。名称的其余部分可以包含除反斜杠字符 (\) 以外的任何字符。有关详细信息，请参阅内核对象命名空间。

注意快速用户切换是使用终端服务会话实现的。要登录的第一个用户使用会话 0，下一个登录的用户使用会话 1，依此而行。内核对象名称必须遵循终端服务概述的准则，以便应用程序可以支持多个用户。

返回值

如果函数成功，则返回值是互斥对象的句柄。

如果函数失败，则返回值为 NULL。要获得更多的错误信息，请调用 GetLastError。

如果命名互斥体不存在，该函数将失败， GetLastError 将返回 ERROR_FILE_NOT_FOUND。

注解

OpenMutex 函数使多个进程能够打开同一互斥对象的句柄。仅当某个进程已使用 CreateMutex 函数创建了互斥体时，函数才会成功。调用进程可以在需要互斥对象句柄的任何函数（如 wait 函数）中使用返回的句柄，但受 dwDesiredAccess 参数中指定的访问限制的约束。

可以使用 DuplicateHandle 函数复制句柄。使用 CloseHandle 函数关闭句柄。进程终止时，系统会自动关闭句柄。互斥对象在其最后一个句柄已关闭时被销毁。

如果多线程应用程序必须重复创建、打开和关闭命名互斥对象，则可能会出现争用条件。在这种情况下，最好使用 CreateMutex 而不是 OpenMutex，因为 CreateMutex 会打开互斥体（如果存在），如果不存在，则创建互斥体。

示例

有关使用 OpenMutex 的示例，请参阅使用命名对象。

要求

要求	值
最低受支持的客户端	Windows XP [桌面应用 \| UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 \| UWP 应用]
目标平台	Windows
标头	synchapi.h (包括 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll