Classe CComCriticalSection

Questa classe fornisce metodi per ottenere e rilasciare la proprietà di un oggetto sezione critica.

Sintassi

class CComCriticalSection

Membri

Costruttori pubblici

Nome	Descrizione
CComCriticalSection::CComCriticalSection	Costruttore.

Metodi pubblici

Nome	Descrizione
CComCriticalSection::Init	Crea e inizializza un oggetto sezione critico.
CComCriticalSection::Lock	Ottiene la proprietà dell'oggetto sezione critica.
CComCriticalSection::Term	Rilascia le risorse di sistema usate dall'oggetto sezione critica.
CComCriticalSection::Unlock	Rilascia la proprietà dell'oggetto sezione critica.

Membri dati pubblici

Nome	Descrizione
CComCriticalSection::m_sec	Oggetto CRITICAL_edizione Standard CTION.

Osservazioni:

CComCriticalSection è simile alla classe CComAutoCriticalSection, ad eccezione del fatto che è necessario inizializzare e rilasciare in modo esplicito la sezione critica.

In genere, si usa CComCriticalSection tramite il typedef nome CriticalSection. Questo nome fa CComCriticalSection riferimento quando viene usato CComMultiThreadModel .

Vedere CComCritSecLock Class (Classe CComCritSecLock) per un modo più sicuro per usare questa classe rispetto alla chiamata Lock diretta e Unlock diretta.

Requisiti

Intestazione: atlcore.h

CComCriticalSection::CComCriticalSection

Costruttore.

CComCriticalSection() throw();

Osservazioni:

Imposta il membro dati m_sec su NULL.

CComCriticalSection::Init

Chiama la funzione Win32 InitializeCriticalSection, che inizializza l'oggetto sezione critica contenuto nel membro dati m_sec .

HRESULT Init() throw();

Valore restituito

Restituisce S_OK in caso di esito positivo, E_OUTOFMEMORY o E_FAIL in caso di errore.

CComCriticalSection::Lock

Chiama la funzione Win32 EnterCriticalSection, che attende fino a quando il thread non può assumere la proprietà dell'oggetto sezione critico contenuto nel membro dati m_sec .

HRESULT Lock() throw();

Valore restituito

Restituisce S_OK in caso di esito positivo, E_OUTOFMEMORY o E_FAIL in caso di errore.

Osservazioni:

L'oggetto sezione critica deve prima essere inizializzato con una chiamata al metodo Init . Al termine dell'esecuzione del codice protetto, il thread deve chiamare Unlock per rilasciare la proprietà della sezione critica.

CComCriticalSection::m_sec

Contiene un oggetto sezione critico utilizzato da tutti i CComCriticalSection metodi.

CRITICAL_SECTION m_sec;

CComCriticalSection::Term

Chiama la funzione Win32 DeleteCriticalSection, che rilascia tutte le risorse usate dall'oggetto sezione critica contenuto nel membro dati m_sec .

HRESULT Term() throw();

Valore restituito

Restituisce S_OK.

Osservazioni:

Una volta Term chiamato, la sezione critica non può più essere usata per la sincronizzazione.

CComCriticalSection::Unlock

Chiama la funzione Win32 LeaveCriticalSection, che rilascia la proprietà dell'oggetto sezione critica contenuto nel membro dati m_sec .

HRESULT Unlock() throw();

Valore restituito

Restituisce S_OK.

Osservazioni:

Per ottenere prima la proprietà, il thread deve chiamare il metodo Lock . Ogni chiamata a Lock richiede una chiamata corrispondente a Unlock per rilasciare la proprietà della sezione critica.

Vedi anche

Classe CComFakeCriticalSection
Cenni preliminari sulla classe
Classe CComCritSecLock