CEvent::CEvent

Artigo
08/25/2010

Constrói um nome ou sem nome CEvent objeto.

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

Parâmetros

bInitiallyOwn
If TRUE, o segmento para o CMultilock or CSingleLock objeto está ativado. Caso contrário, todos os threads que desejam acessar o recurso devem aguardar.
bManualReset
If TRUE, especifica que o objeto de evento é um evento manual, caso contrário, o objeto de evento é um evento automático.
lpszName
Nome do CEvent objeto. Deve ser fornecido se o objeto será usado em limites de processo.Se o nome corresponde a um evento já existente, o construtor cria um novo CEvent objeto que referencia o evento esse nome. Se o nome corresponde a um objeto de sincronização existente que não é um evento, a construção falhará.If NULO, o nome será nulo.
lpsaAttribute
Atributos de segurança para o objeto de evento.Para obter uma descrição completa dessa estrutura, consulte SECURITY_ATTRIBUTES in the Windows SDK.

Comentários

Para acessar ou liberar um CEvent objeto, criar um CMultiLock or CSingleLock object e chamar seus bloquear and Desbloquear funções de membro.

Para alterar o estado de um CEvent objeto sinalizado (segmentos não têm que esperar) telefonar SetEvent or PulseEvent.Para conjunto o estado de um CEvent objeto retornados para nonsignaled (segmentos devem aguardar), telefonar ResetEvent.

Observação de segurança:
Depois de criar o CEvent objeto, uso GetLastError para garantir que o mutex não existe.Se o mutex existissem inesperadamente, isso pode indicar um processo não autorizado é squatting e pode ser pretende usar o mutex de maneira mal-intencionada.Nesse caso, o procedimento recomendado sensível à segurança é fechar o identificador e continuar sistema autônomo se houve uma falha na criação do objeto.

Depois de criar o CEvent objeto, uso GetLastError para garantir que o mutex não existe.Se o mutex existissem inesperadamente, isso pode indicar um processo não autorizado é squatting e pode ser pretende usar o mutex de maneira mal-intencionada.Nesse caso, o procedimento recomendado sensível à segurança é fechar o identificador e continuar sistema autônomo se houve uma falha na criação do objeto.