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 de CEvent

Gráfico de hierarquia