CComCriticalSection (clase)

Esta clase proporciona métodos para obtener y liberar la propiedad de un objeto de sección crítica.

Sintaxis

class CComCriticalSection

Miembros

Constructores públicos

Métodos públicos

Miembros de datos públicos

Comentarios

CComCriticalSection es similar a la clase CComAutoCriticalSection, salvo que debe inicializar y liberar explícitamente la sección crítica.

Normalmente, CComCriticalSection se usa por medio del nombre de typedef CriticalSection. Este nombre hace referencia a CComCriticalSection cuando se usa CComMultiThreadModel.

Consulte la clase CComCritSecLock para conocer una manera más segura de usar esta clase que llamar a Lock y Unlock directamente.

Requisitos

Encabezado: atlcore.h

CComCriticalSection::CComCriticalSection

Constructor .

CComCriticalSection() throw();

Comentarios

Establece el miembro de datos m_sec en NULL.

CComCriticalSection::Init

Llama a la función InitializeCriticalSection de Win32, que inicializa el objeto de sección crítica contenido en el miembro de datos m_sec.

HRESULT Init() throw();

Valor devuelto

Devuelve S_OK si se ejecuta correctamente y E_OUTOFMEMORY o E_FAIL en caso de error.

CComCriticalSection::Lock

Llama a la función EnterCriticalSection de Win32, que espera hasta que el subproceso pueda tomar la propiedad del objeto de sección crítica contenido en el miembro de datos m_sec.

HRESULT Lock() throw();

Valor devuelto

Devuelve S_OK si se ejecuta correctamente y E_OUTOFMEMORY o E_FAIL en caso de error.

Comentarios

El objeto de sección crítica se debe inicializar primero con una llamada al método Init. Cuando el código protegido haya terminado de ejecutarse, el subproceso debe llamar a Unlock para liberar la propiedad de la sección crítica.

CComCriticalSection::m_sec

Contiene un objeto de sección crítica que usan todos los métodos CComCriticalSection.

CRITICAL_SECTION m_sec;

CComCriticalSection::Term

Llama a la función DeleteCriticalSection de Win32, que libera todos los recursos utilizados por el objeto de sección crítica contenido en el miembro de datos m_sec.

HRESULT Term() throw();

Valor devuelto

Devuelve S_OK.

Comentarios

Una vez que se ha llamado a Term, la sección crítica ya no se puede usar para la sincronización.

CComCriticalSection::Unlock

Llama a la función LeaveCriticalSection de Win32, que libera la propiedad del objeto de sección crítica contenido en el miembro de datos m_sec.

HRESULT Unlock() throw();

Valor devuelto

Devuelve S_OK.

Comentarios

Para obtener primero la propiedad, el subproceso debe llamar al método Lock. Cada llamada a Lock requiere una llamada correspondiente a Unlock para liberar la propiedad de la sección crítica.

Consulte también

CComFakeCriticalSection (clase)
Información general sobre la clase
CComCritSecLock (clase)