CHandle Sınıfı

Bu sınıf, tanıtıcı nesnesi oluşturmak ve kullanmak için yöntemler sağlar.

Sözdizimi

class CHandle

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CHandle::CHandle	Oluşturucu.
CHandle::~CHandle	Yok edici.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CHandle::Attach	Nesneyi var olan bir tanıtıcıya eklemek CHandle için bu yöntemi çağırın.
CHandle::Close	Bir CHandle nesneyi kapatmak için bu yöntemi çağır.
CHandle::D etach	Bir tanıtıcıyı nesneden CHandle ayırmak için bu yöntemi çağır.

Ortak İşleçler

Veri Akışı Adı	Açıklama
CHandle::operator HANDLE	Depolanan tanıtıcının değerini döndürür.
CHandle::operator =	Atama işleci.

Ortak Veri Üyeleri

Veri Akışı Adı	Açıklama
CHandle::m_h	Tanıtıcıyı depolayan üye değişkeni.

Açıklamalar

Bir CHandle tanıtıcı gerektiğinde nesne kullanılabilir: temel fark, nesnenin CHandle otomatik olarak silinmesidir.

Not

Bazı API işlevleri boş veya geçersiz tanıtıcı olarak NULL kullanırken, diğerleri INVALID_HANDLE_VALUE kullanır. CHandle yalnızca NULL kullanır ve INVALID_HANDLE_VALUE gerçek tanıtıcı olarak kabul eder. INVALID_HANDLE_VALUE döndürebilen bir API çağırırsanız, CHandle::Attach'ı çağırmadan veya oluşturucuya CHandle geçirmeden önce bu değeri denetlemeniz ve bunun yerine NULL geçirmeniz gerekir.

Gereksinimler

Üst bilgi: atlbase.h

CHandle::Attach

Nesneyi var olan bir tanıtıcıya eklemek CHandle için bu yöntemi çağırın.

void Attach(HANDLE h) throw();

Parametreler

h
CHandleh tutamacının sahipliğini alır.

Açıklamalar

nesnesini h tanıtıcısına atar ve h.Detach() öğesini çağırır.CHandle Hata ayıklama derlemelerinde, h NULL olduğunda bir ATLASSERT oluşturulur. Tanıtıcının geçerliliği için başka bir denetim yapılmaz.

CHandle::CHandle

Oluşturucu.

CHandle() throw();
CHandle(CHandle& h) throw();
explicit CHandle(HANDLE h) throw();

Parametreler

h
Var olan bir tanıtıcı veya CHandle.

Açıklamalar

İsteğe bağlı olarak mevcut tanıtıcıyı veya CHandle nesneyi kullanarak yeni CHandle bir nesne oluşturur.

CHandle::~CHandle

Yok edici.

~CHandle() throw();

Açıklamalar

CHandle CHandle::Close çağrısı yaparak nesneyi serbesttir.

CHandle::Close

Bir CHandle nesneyi kapatmak için bu yöntemi çağır.

void Close() throw();

Açıklamalar

Açık bir nesne tutamacını kapatır. Tanıtıcı NULL ise, zaten çağrıldıysa Close bu durum geçerli olur, hata ayıklama derlemelerinde bir ATLASSERT oluşturulur.

CHandle::D etach

Bir tanıtıcıyı nesneden CHandle ayırmak için bu yöntemi çağır.

HANDLE Detach() throw();

Dönüş Değeri

Ayrılan tanıtıcıyı döndürür.

Açıklamalar

Tanıtıcının sahipliğini serbest bırakır.

CHandle::m_h

Tanıtıcıyı depolayan üye değişkeni.

HANDLE m_h;

CHandle::operator =

Atama işleci.

CHandle& operator=(CHandle& h) throw();

Parametreler

h
CHandleh tutamacının sahipliğini alır.

Dönüş Değeri

Yeni CHandle nesneye bir başvuru döndürür.

Açıklamalar

Nesne şu CHandle anda bir tanıtıcı içeriyorsa kapatılır. geçirilen nesnenin CHandle tanıtıcı başvurusu NULL olarak ayarlanır. Bu, iki CHandle nesnenin hiçbir zaman aynı etkin tanıtıcıyı içermemesini sağlar.

CHandle::operator HANDLE

Depolanan tanıtıcının değerini döndürür.

operator HANDLE() const throw();

Açıklamalar

CHandle::m_h içinde depolanan değeri döndürür.

Ayrıca bkz.

Sınıfa Genel Bakış