HandleT Sınıfı

Bir nesnenin tanıtıcısını temsil eder.

Sözdizimi

template <typename HandleTraits>
class HandleT;

Parametreler

HandleTraits
Tanıtıcının ortak özelliklerini tanımlayan HandleTraits yapısının bir örneği.

Üyeler

Genel Tür Tanımları

Ad	Tanım
Traits	için HandleTraitsbir eş anlamlı.

Ortak Oluşturucular

Ad	Tanım
HandleT::HandleT	HandleT sınıfının yeni bir örneğini başlatır.
HandleT::~HandleT	Sınıfının bir örneğini HandleT başlatır.

Genel Yöntemler

Ad	Tanım
HandleT::Attach	Belirtilen tanıtıcıyı geçerli HandleT nesneyle ilişkilendirir.
HandleT::Close	Geçerli HandleT nesneyi kapatır.
HandleT::D etach	Geçerli HandleT nesnenin temel alınan tanıtıcısından ayrıştırılması.
HandleT::Get	Temel alınan tanıtıcının değerini alır.
HandleT::IsValid	Geçerli HandleT nesnenin bir tanıtıcıyı temsil edip etmediğini gösterir.

Korumalı Yöntemler

Ad	Tanım
HandleT::InternalClose	Geçerli HandleT nesneyi kapatır.

Ortak İşleçler

Ad	Tanım
HandleT::operator=	Belirtilen HandleT nesnenin değerini geçerli HandleT nesneye taşır.

Korumalı Veri Üyeleri

Ad	Tanım
HandleT::handle_	Nesnesi tarafından temsil edilen tanıtıcıyı HandleT içerir.

Devralma Hiyerarşisi

HandleT

Gereksinimler

Üst bilgi: corewrappers.h

Ad Alanı: Microsoft::WRL::Wrappers

HandleT::~HandleT

Sınıfının bir örneğini HandleT başlatır.

~HandleT();

HandleT::Attach

Belirtilen tanıtıcıyı geçerli HandleT nesneyle ilişkilendirir.

void Attach(
   typename HandleTraits::Type h
);

Parametreler

h
Bir tutamaç.

HandleT::Close

Geçerli HandleT nesneyi kapatır.

void Close();

Açıklamalar

Geçerlinin HandleT altındaki tanıtıcı kapatılır ve HandleT geçersiz duruma ayarlanır.

Tanıtıcı düzgün kapatılmıyorsa, çağıran iş parçacığında bir özel durum oluşturulur.

HandleT::D etach

Geçerli HandleT nesnenin temel alınan tanıtıcısından ayrıştırılması.

typename HandleTraits::Type Detach();

İade Değeri

Temel alınan tanıtıcı.

Açıklamalar

Bu işlem tamamlandığında, geçerli HandleT geçersiz duruma ayarlanır.

HandleT::Get

Temel alınan tanıtıcının değerini alır.

typename HandleTraits::Type Get() const;

İade Değeri

Bir tutamaç.

HandleT::handle_

Nesnesi tarafından temsil edilen tanıtıcıyı HandleT içerir.

typename HandleTraits::Type handle_;

HandleT::HandleT

HandleT sınıfının yeni bir örneğini başlatır.

explicit HandleT(
   typename HandleTraits::Type h =
      HandleTraits::GetInvalidValue()
);

HandleT(
   _Inout_ HandleT&& h
);

Parametreler

h
Bir tutamaç.

Açıklamalar

İlk oluşturucu, bir HandleT nesne için geçerli tanıtıcı olmayan bir nesne başlatır. İkinci oluşturucu h parametresinden yeni HandleT bir nesne oluşturur.

HandleT::InternalClose

Geçerli HandleT nesneyi kapatır.

virtual bool InternalClose();

İade Değeri

true geçerli HandleT başarıyla kapatıldıysa; değilse, false.

Açıklamalar

InternalClose()protected.

HandleT::IsValid

Geçerli HandleT nesnenin bir tanıtıcıyı temsil edip etmediğini gösterir.

bool IsValid() const;

İade Değeri

true bir tanıtıcıyı HandleT temsil ederse; değilse, false.

HandleT::operator=

Belirtilen HandleT nesnenin değerini geçerli HandleT nesneye taşır.

HandleT& operator=(
   _Inout_ HandleT&& h
);

Parametreler

h
Bir tanıtıcıya rvalue-başvurusu.

İade Değeri

Geçerli HandleT nesneye başvuru.

Açıklamalar

Bu işlem, h parametresi tarafından belirtilen nesneyi geçersiz hale HandleT döndürür.