Classe CComCriticalSection

Essa classe fornece métodos para obter e liberar a propriedade de um objeto de seção crítico.

Sintaxe

class CComCriticalSection

Membros

Construtores públicos

Nome	Descrição
CComCriticalSection::CComCriticalSection	O construtor .

Métodos públicos

Nome	Descrição
CComCriticalSection::Init	Cria e inicializa um objeto de seção crítica.
CComCriticalSection::Lock	Obtém a propriedade do objeto de seção crítica.
CComCriticalSection::Term	Libera recursos do sistema usados pelo objeto de seção crítica.
CComCriticalSection::Unlock	Libera a propriedade do objeto de seção crítica.

Membros de Dados Públicos

Nome	Descrição
CComCriticalSection::m_sec	Um objeto CRITICAL_SECTION.

Comentários

CComCriticalSection é semelhante à classe CComAutoCriticalSection, com a exceção de que você deve inicializar e liberar explicitamente a seção crítica.

Normalmente, você usa CComCriticalSection por meio do nome de typedefCriticalSection. Esse nome faz referência a CComCriticalSection quando CComMultiThreadModel estiver sendo usado.

Confira a Classe CComCritSecLock para obter uma forma mais segura de usar essa classe do que chamar Lock e Unlock diretamente.

Requisitos

Cabeçalho: atlcore.h

CComCriticalSection::CComCriticalSection

O construtor .

CComCriticalSection() throw();

Comentários

Define o membro de dados m_sec como NULL.

CComCriticalSection::Init

Chama a função Win32 InitializeCriticalSection, que inicializa o objeto de seção crítica contido no membro de dados m_sec.

HRESULT Init() throw();

Valor de Devolução

Retorna S_OK em caso de êxito e E_OUTOFMEMORY ou E_FAIL em caso de falha.

CComCriticalSection::Lock

Chama a função Win32 EnterCriticalSection, que aguarda até que o thread possa assumir a propriedade do objeto de seção crítica contido no membro de dados m_sec.

HRESULT Lock() throw();

Valor de Devolução

Retorna S_OK em caso de êxito e E_OUTOFMEMORY ou E_FAIL em caso de falha.

Comentários

Primeiro, o objeto de seção crítica deve ser inicializado com uma chamada para o método Init. Quando o código protegido terminar de ser executado, o thread deverá chamar Desbloqueio para liberar a propriedade da seção crítica.

CComCriticalSection::m_sec

Contém um objeto de seção crítico que é usado por todos os métodos CComCriticalSection.

CRITICAL_SECTION m_sec;

CComCriticalSection::Term

Chama a função Win32 DeleteCriticalSection, que libera todos os recursos usados pelo objeto de seção crítica contido no membro de dados m_sec.

HRESULT Term() throw();

Valor de Devolução

Returns S_OK.

Comentários

Depois que Term for chamado, a seção crítica não poderá mais ser usada para sincronização.

CComCriticalSection::Unlock

Chama a função Win32 LeaveCriticalSection, que libera a propriedade do objeto de seção crítica contido no membro de dados m_sec.

HRESULT Unlock() throw();

Valor de Devolução

Returns S_OK.

Comentários

Para obter a propriedade primeiro, o thread deve chamar o método Lock. Cada chamada de Lock exige uma chamada correspondente de Unlock para liberar a propriedade da seção crítica.

Confira também

Classe CComFakeCriticalSection
Visão geral da classe
Classe CComCritSecLock