TryEnterCriticalSection 함수(synchapi.h)

아티클
02/05/2024

차단 없이 중요한 섹션을 입력하려고 시도합니다. 호출이 성공하면 호출 스레드는 중요한 섹션의 소유권을 맡습니다.

구문

BOOL TryEnterCriticalSection(
  [in, out] LPCRITICAL_SECTION lpCriticalSection
);

매개 변수

[in, out] lpCriticalSection

중요한 섹션 개체에 대한 포인터입니다.

반환 값

중요 섹션이 성공적으로 입력되었거나 현재 스레드가 이미 중요 섹션을 소유하고 있는 경우 반환 값은 0이 아닌 것입니다.

다른 스레드가 이미 중요 섹션을 소유하는 경우 반환 값은 0입니다.

설명

단일 프로세스의 스레드는 상호 배제 동기화에 중요한 섹션 개체를 사용할 수 있습니다. 프로세스는 CRITICAL_SECTION 형식의 변수를 선언하여 수행할 수 있는 중요한 섹션 개체에 사용되는 메모리를 할당합니다. 중요한 섹션을 사용하기 전에 프로세스의 일부 스레드는 개체를 초기 화하기 위해 InitializeCriticalSection 또는 InitializeCriticalSectionAndSpinCount 함수를 호출해야 합니다.

공유 리소스를 상호 배타적으로 사용할 수 있도록 하기 위해 각 스레드는 EnterCriticalSection 또는 TryEnterCriticalSection 함수를 호출하여 보호된 리소스를 사용하는 코드 섹션을 실행하기 전에 중요한 섹션의 소유권을 요청합니다. 차이점은 TryEnterCriticalSection 이 중요한 섹션의 소유권을 얻었는지 여부에 관계없이 즉시 반환되는 반면 , EnterCriticalSection 은 스레드가 중요한 섹션의 소유권을 가져올 때까지 차단된다는 것입니다. 보호된 코드 실행이 완료되면 스레드는 LeaveCriticalSection 함수를 사용하여 소유권을 포기하므로 다른 스레드가 소유자가 되고 보호된 리소스에 액세스할 수 있습니다. 스레드는 중요 섹션에 들어갈 때마다 LeaveCriticalSection 을 한 번 호출해야 합니다.

프로세스의 모든 스레드는 DeleteCriticalSection 함수를 사용하여 중요한 섹션 개체가 초기화될 때 할당된 시스템 리소스를 해제할 수 있습니다. 이 함수가 호출된 후에는 더 이상 동기화에 중요한 섹션 개체를 사용할 수 없습니다.

스레드가 중요한 섹션의 소유권을 가지고 있는 동안 종료되는 경우 위험 섹션의 상태는 정의되지 않습니다.

이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT0x0400 이상으로 정의합니다. 자세한 내용은 Windows 헤더 사용을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows XP [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	synchapi.h(Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2에 Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll