Función SetEvent (synchapi.h)
Establece el objeto de evento especificado en el estado señalado.
Sintaxis
BOOL SetEvent(
[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 de restablecimiento manual permanece señalado hasta que se establece explícitamente en el estado no asignado por la función ResetEvent . Cualquier número de subprocesos en espera o subprocesos que posteriormente inicien operaciones de espera para el objeto de evento especificado mediante una llamada a una de las funciones de espera, se puede liberar mientras se señala el estado del objeto.
En cambio, el estado de un objeto de evento de restablecimiento automático permanece señalado hasta que se libera un único subproceso en espera, en cuyo momento el sistema establece automáticamente el estado en no asignado. Si no hay subprocesos en espera, el objeto del evento sigue teniendo el estado señalizado.
Establecer un evento que ya está establecido no tiene ningún efecto.
Las aplicaciones de la Tienda Windows pueden responder a eventos con nombre y semáforos como se describe en Cómo responder a eventos con nombre y semáforos.
Ejemplos
Para obtener un ejemplo que usa SetEvent, vea Usar objetos de evento.
Requisitos
| Requisito | Value |
|---|---|
| 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 |