ResetEvent
9/8/2008
Essa função define o estado do objeto de evento especificado para não sinalizado.
Syntax
BOOL ResetEvent(
HANDLE hEvent
);
Parameters
- hEvent
[no] Identificador para o objeto evento, retornado pela função a CreateEvent.
Return Value
Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.
Remarks
ResetEvent retorna FALSE se o identificador para o objeto evento for inválido.
O estado de um evento objeto permanece não sinalizado até que ela seja definido explicitamente como sinalizado pelo SetEvent ou PulseEvent função. Esta não sinalizado estado bloqueia a execução de qualquer segmentos que tenha especificado o objeto evento em um chamar a uma das funções de espera.
ResetEvent Define o evento para o não sinalizado estado mesmo se o evento foi sinalizado múltiplo vezes antes que está sendo sinalizado. O ResetEvent função é usada principalmente para objetos evento Sinal manual, que devem ser definidos explicitamente para o não sinalizado estado. Evento Auto-Signal objetos automaticamente alteração de sinalizado para não sinalizado após um único segmento de espera é liberado.
Cada tipo objeto, such as memória mapas, semáforos, eventos, mensagem filas, exclusões mútuas e timers de monitoração, tem sua própria separar espaço para nome. Esvaziar seqüências de caracteres, " ", são tratados como nomeado objetos. Em plataformas com base em Área de trabalho Windows, sincronização objetos todos compartilhar o mesmo namespace.
Requirements
Header | kfuncs.h |
Library | coredll.lib |
Windows Embedded CE | Windows CE 1.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
Synchronization Functions
CreateEvent
PulseEvent
OpenEvent
SetEvent