Compartilhar via


ResetEvent

Windows Mobile SupportedWindows Embedded CE Supported

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