Partilhar via


CEvent::CEvent

Constrói um objeto chamado ou sem nome de CEvent .

CEvent( 
   BOOL bInitiallyOwn = FALSE, 
   BOOL bManualReset = FALSE, 
   LPCTSTR lpszName = NULL, 
   LPSECURITY_ATTRIBUTES lpsaAttribute = NULL  
);

Parâmetros

  • bInitiallyOwn
    Se Verdadeiro, o segmento para CMultilock ou objeto de CSingleLock estão habilitados. Caso contrário, todos os segmentos que deseja acessar o recurso devem aguardar.

  • bManualReset
    Se Verdadeiro, especifica que o objeto de evento é um evento manual, não se o objeto de evento é um evento automático.

  • lpszName
    Nome do objeto de CEvent . Deve ser fornecido se o objeto será usado fora dos limites de processo. Se o nome corresponde a um evento existente, o construtor cria um novo objeto de CEvent que referencia o evento de aquele nome. Se o nome corresponde a um objeto existente de sincronização que não é um evento, a compilação falhará. Se NULO, o nome será nulo.

  • lpsaAttribute
    Atributos de segurança para o objeto de evento. Para obter uma descrição completa de essa estrutura, consulte SECURITY_ATTRIBUTES em Windows SDK.

Comentários

Para acessar ou liberar um objeto de CEvent , crie um objeto de CMultiLock ou de CSingleLock e chamar as funções de membro de Bloquear e de desbloquear .

Para alterar o estado de um objeto de CEvent para sinalizar (segmentos não têm que aguardar), chamada SetEvent ou PulseEvent. Para definir o estado de um objeto de CEvent para não sinalizados (segmentos devem aguardar), ResetEventchamada.

Observação de segurançaObservação de segurança

Após criar o objeto de CEvent , use GetLastError garantir que o mutex já não existe.Se o mutex existiu inesperadamente, pode indicar que um processo desonesto squatting e pretender pode usar maliciosa o mutex.Em esse caso, o procedimento de segurança consciente recomendado é feche o identificador e continuar como se houver uma falha na criação do objeto.

Requisitos

Cabeçalho: afxmt.h

Consulte também

Referência

Classe CEvent

Gráfico da hierarquia