EnterCriticalSection 函数 (synchapi.h)

项目
03/09/2024

等待指定关键部分对象的所有权。此函数将在授予调用线程所有权时返回。

语法

void EnterCriticalSection(
  [in, out] LPCRITICAL_SECTION lpCriticalSection
);

参数

[in, out] lpCriticalSection

指向关键节对象的指针。

返回值

此函数不返回值。

如果关键节上的等待操作超时，此函数可能会引发 EXCEPTION_POSSIBLE_DEADLOCK（也称为 STATUS_POSSIBLE_DEADLOCK）。超时间隔由以下注册表值指定： HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\CriticalSectionTimeout。不处理可能的死锁异常;而是调试应用程序。

注解

单个进程的线程可以使用关键节对象进行互斥同步。进程负责分配关键节对象使用的内存，可以通过声明 CRITICAL_SECTION类型的变量来执行此操作。在使用关键节之前，进程的某个线程必须调用 InitializeCriticalSection 或 InitializeCriticalSectionAndSpinCount 来初始化对象。

为了启用对共享资源的互斥访问，每个线程调用 EnterCriticalSection 或 TryEnterCriticalSection 函数，以在执行访问受保护资源的任何代码部分之前请求关键节的所有权。区别在于，无论它是否获得了关键节的所有权， TryEnterCriticalSection 都会立即返回，而 EnterCriticalSection 将阻止，直到线程可以获取关键节的所有权。完成执行受保护的代码后，线程将使用 LeaveCriticalSection 函数放弃所有权，使另一个线程成为所有者并访问受保护的资源。无法保证等待线程获取关键节所有权的顺序。

线程拥有关键节的所有权后，它可以对 EnterCriticalSection 或 TryEnterCriticalSection 进行其他调用，而不会阻止其执行。这可以防止线程在等待它已拥有的关键节时自行死锁。每次 EnterCriticalSection 和 TryEnterCriticalSection 成功时，线程都会进入关键部分。每次进入关键部分时，线程都必须调用 LeaveCriticalSection 一次。

进程的任何线程都可以使用 DeleteCriticalSection 函数释放在初始化关键节对象时分配的系统资源。调用此函数后，不能再使用关键节对象进行同步。

如果线程在拥有关键节的所有权时终止，则关键节的状态为未定义。

如果在某个关键节仍归其所有的情况下被删除，则等待已删除的关键节所有权的线程的状态为未定义。

当进程退出时，如果调用 EnterCriticalSection 会阻止，它将立即终止进程。这可能会导致不调用全局析构函数。

示例

有关使用 EnterCriticalSection 的示例，请参阅使用关键节对象。

要求

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