Compartilhar via

OpenEvent

  • Artigo

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

Essa função abrirá um nomeado existente objeto evento.

Syntax

HANDLE OpenEvent(
  DWORD dwDesiredAccess,
  BOOL bInheritHandle,
  LPCTSTR lpName
);

Parameters

  • dwDesiredAccess
    [no] Especifica a acessar solicitada para o objeto evento. Para sistemas que suporte objeto segurança, a função falhará se a descritor de segurança do objeto especificado não permite a acessar solicitada para o processo de chamada.

    dwDesiredAccess Também deverá ser definido EVENT_ALL_ACCESS para especificar possível acessar todos os sinalizadores para o objeto evento

  • bInheritHandle
    [no] Especifica se o identificador retornado é herdável. Deve ser definido como FALSE.
  • lpName
    [no] Ponteiro para uma seqüência de caracteres NULL-Terminated que nomes de evento a ser aberto. Nome comparações são com diferenciação de maiúsculas e minúsculas. 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.

Return Value

Um identificador para o objeto evento indica sucesso. NULL Indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

O OpenEvent função ativa múltiplo processa a aberto trata do mesmo objeto evento. A função é bem-sucedida somente se algum processo já tiver criado o evento usando a função CreateEvent. O processo de chamada pode usar o identificador retornado em qualquer função que requer um identificador para um objeto evento, assunto às limitações da acessar especificado na dwDesiredAccess parâmetro.

Use o DuplicateHandle função para o identificador duplicado. Use a função CloseHandle para fechar o identificador. O sistema fecha o identificador automaticamente quando o processo termina. O objeto evento é destruído ao seu último identificador foi fechada.

Requirements

Header winbase.h
Library coredll.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Synchronization Functions
ResetEvent
SetEvent
CreateEvent
OpenEvent
CreateProcess
DuplicateHandle
PulseEvent

Other Resources

CloseHandle