Función ResetEvent (synchapi.h)

Artículo
08/26/2023

Establece el objeto de evento especificado en el estado no asignado.

Sintaxis

BOOL ResetEvent(
  [in] HANDLE hEvent
);

Parámetros

[in] hEvent

Identificador del objeto de evento. La función CreateEvent o OpenEvent devuelve este identificador.

El identificador debe tener el derecho de acceso EVENT_MODIFY_STATE. Para obtener más información, vea Synchronization Object Security and Access Rights.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

El estado de un objeto de evento permanece sin signo hasta que se establece explícitamente en señalado por la función SetEvent o PulseEvent . Este estado no asignado bloquea la ejecución de cualquier subproceso que haya especificado el objeto de evento en una llamada a una de las funciones de espera.

La función ResetEvent se usa principalmente para objetos de evento de restablecimiento manual, que se deben establecer explícitamente en el estado no asignado. Los objetos de evento de restablecimiento automático cambian automáticamente de señalizado a no asignado después de que se libere un único subproceso en espera.

Restablecer un evento que ya se restablece no tiene ningún efecto.

Requisitos


Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	synchapi.h (incluye Windows.h en Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll