SetEvent 함수(synchapi.h)

아티클
03/02/2024

지정된 이벤트 개체를 신호 상태로 설정합니다.

구문

BOOL SetEvent(
  [in] HANDLE hEvent
);

매개 변수

[in] hEvent

이벤트 개체에 대한 핸들입니다. CreateEvent 또는 OpenEvent 함수는 이 핸들을 반환합니다.

핸들에는 EVENT_MODIFY_STATE 액세스 권한이 있어야 합니다. 자세한 내용은 동기화 개체 보안 및 액세스 권한을 참조하세요.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

ResetEvent 함수에 의해 명시적으로 서명되지 않은 상태로 설정될 때까지 수동 재설정 이벤트 개체의 상태는 신호로 유지됩니다. 대기 함수 중 하나를 호출하여 지정된 이벤트 개체에 대한 대기 작업을 시작한 대기 스레드 또는 스레드는 개체의 상태가 신호를 받는 동안 해제될 수 있습니다.

반면, 자동 재설정 이벤트 개체의 상태는 단일 대기 스레드가 해제될 때까지 신호를 유지하며, 이때 시스템은 자동으로 상태를 서명되지 않은 상태로 설정합니다. 대기 스레드가 없으면 이벤트 개체의 상태는 신호를 받은 것으로 유지됩니다.

이미 설정된 이벤트를 설정해도 아무런 효과가 없습니다.

Windows 스토어 앱은 명명된 이벤트 및 세마 포에 응답하는 방법에 설명된 대로 명명된 이벤트 및 세마포에 응답할 수 있습니다.

예제

SetEvent를 사용하는 예제는 이벤트 개체 사용을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	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