CEvent::CEvent

Costruisce un oggetto denominato o senza nome CEvent.

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

Parametri

• bInitiallyOwn
  Se TRUE, il thread per CMultilock o l'oggetto CSingleLock è abilitato.In caso contrario, tutti i thread che desiderano accedere alla risorsa devono attendere.

• bManualReset
  Se TRUE, specifica che l'oggetto evento è un evento manuale, in caso contrario l'oggetto evento è un evento automatico.

• lpszName
  Nome dell'oggetto CEvent.Deve essere fornito se l'oggetto verrà utilizzato oltre i limiti dei processi.Se il nome corrisponde a un evento esistente, il costruttore compila un nuovo oggetto CEvent che fa riferimento all'evento con tale nome.Se il nome corrisponde a un oggetto di sincronizzazione esistente non incluso un evento, la costruzione non riuscirà.Se NULL, il nome sarà null.

• lpsaAttribute
  Attributi di sicurezza per l'oggetto evento.Per una descrizione completa della struttura, vedere SECURITY_ATTRIBUTES in Windows SDK.

Note

Per accedere a o eliminare un oggetto CEvent, creare un oggetto CSingleLock o CMultiLock e chiamare i blocco funzioni membro e Sblocca.

Per modificare lo stato di un oggetto CEvent a segnalato a (thread non devono attendere), chiamata SetEvent o PulseEvent.Per impostare lo stato di un oggetto CEvent a non segnalato (thread devono attendere), chiamata ResetEvent.

Nota sulla sicurezza

Dopo aver creato l'oggetto CEvent, utilizzare GetLastError assicurarsi che il mutex non sono già presenti.Se il mutex esistessero in modo imprevisto, possono indicare che tolga le erbacce dal processo sta occupando e può si intendeva utilizzare intenzionalmente il mutex.In questo caso, la routine sicurezza consapevole consigliata consiste nel chiudere l'handle e di continuare come se si trattasse di un errore nel creare l'oggetto.

Requisiti

Header: afxmt.h

Vedere anche

Riferimenti

Classe di CEvent

Grafico della gerarchia