ResetEvent 함수(synchapi.h)

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

구문

BOOL ResetEvent(
  [in] HANDLE hEvent
);

매개 변수

[in] hEvent

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

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

반환 값

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

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

설명

SetEvent 또는 PulseEvent 함수에 의해 명시적으로 신호로 설정될 때까지 이벤트 개체의 상태는 서명되지 않은 상태로 유지됩니다. 이 서명되지 않은 상태는 대기 함수 중 하나에 대한 호출에서 이벤트 개체를 지정한 스레드의 실행을 차단합니다.

ResetEvent 함수는 주로 서명되지 않은 상태로 명시적으로 설정해야 하는 수동 재설정 이벤트 개체에 사용됩니다. 자동 재설정 이벤트 개체는 단일 대기 스레드가 해제된 후 신호에서 서명되지 않은 것으로 자동으로 변경됩니다.

이미 재설정된 이벤트를 다시 설정하는 것은 아무런 영향을 주지 않습니다.

요구 사항

참고 항목

CreateEvent

이벤트 개체

OpenEvent

PulseEvent

SetEvent

동기화 함수