CEvent::CEvent

Article
06/10/2015

Construit un objet nommé ou sans nom d' CEvent .

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

Paramètres

bInitiallyOwn
Si TRUE, le thread pour CMultilock ou l'objet d' CSingleLock est activé. Sinon, tous les threads souhaitant accéder à la ressource doivent attendre.
bManualReset
Si TRUE, spécifie que l'objet événement est un événement manuel, sinon l'objet événement est un événement automatique.
lpszName
Nom de l'objet CEvent. Doit être fourni si l'objet est utilisé au delà de les limites du processus. Si le nom correspond à un événement existant, le constructeur crée un nouvel objet d' CEvent qui référence l'événement de ce nom. Si le nom correspond à un objet de synchronisation existant qui n'est pas un événement, la construction échoue. Si NULL, le nom sera null.
lpsaAttribute
Attributs de sécurité pour l'objet événement. Pour une description complète de cette structure, consultez SECURITY_ATTRIBUTES dans Kit de développement logiciel Windows.

Notes

Pour accéder ou libérer à un objet d' CEvent , créez un objet de CMultiLock ou de CSingleLock et appelez ses fonctions membres de Verrouillage et de déverrouillez .

Pour modifier l'état d'un objet d' CEvent soit signalé (les threads ne doit pas attendre), appelez SetEvent ou PulseEvent. Pour définir l'état d'un objet d' CEvent à non signalé (les threads doivent attendre), appelez ResetEvent.

Note de sécurité
Après avoir créé l'objet d' CEvent , utilisez GetLastError de s'assurer que le mutex n'ont pas encore existé.Si le mutex existaient de façon inattendue, ils peuvent indiquer débarrassent des plants peu vigoureux le processus s'accroupissent et peuvent s'attendre à utiliser les mutex de manière malveillante.Dans ce cas, la procédure consciente de sécurité est recommandé de fermer le handle et de continuer comme s'il y avait un échec en créant l'objet.

Après avoir créé l'objet d' CEvent , utilisez GetLastError de s'assurer que le mutex n'ont pas encore existé.Si le mutex existaient de façon inattendue, ils peuvent indiquer débarrassent des plants peu vigoureux le processus s'accroupissent et peuvent s'attendre à utiliser les mutex de manière malveillante.Dans ce cas, la procédure consciente de sécurité est recommandé de fermer le handle et de continuer comme s'il y avait un échec en créant l'objet.

Configuration requise

Header: afxmt.h

Voir aussi

Référence

CEvent, classe

Graphique de la hiérarchie

Partager via