Sdílet prostřednictvím

HandleT – třída

  • Článek

Představuje popisovač objektu.

Syntaxe

template <typename HandleTraits>
class HandleT;

Parametry

HandleTraits
Instance HandleTraits struktury, která definuje běžné vlastnosti popisovače.

Členové

Veřejné definice typedef

Název Popis
Traits Synonymum pro HandleTraits.

Veřejné konstruktory

Název Popis
HandleT::HandleT Inicializuje novou instanci HandleT třídy.
HandleT::~HandleT Deinicializuje instanci HandleT třídy.

Veřejné metody

Název Popis
HandleT::Attach Přidruží zadaný popisovač k aktuálnímu HandleT objektu.
HandleT::Close Zavře aktuální HandleT objekt.
HandleT::D etach Oddružuje aktuální HandleT objekt od jeho podkladového popisovače.
HandleT::Get Získá hodnotu podkladového popisovače.
HandleT::IsValid Určuje, zda aktuální HandleT objekt představuje popisovač.

Chráněné metody

Název Popis
HandleT::InternalClose Zavře aktuální HandleT objekt.

Veřejné operátory

Název Popis
HandleT::operator= Přesune hodnotu zadaného HandleT objektu do aktuálního HandleT objektu.

Chráněné datové členy

Název Popis
HandleT::handle_ Obsahuje popisovač, který je reprezentován objektem HandleT .

Hierarchie dědičnosti

HandleT

Požadavky

Hlavička: corewrappers.h

Obor názvů: Microsoft::WRL::Wrappers

HandleT::~HandleT

Deinicializuje instanci HandleT třídy.

~HandleT();

HandleT::Attach

Přidruží zadaný popisovač k aktuálnímu HandleT objektu.

void Attach(
   typename HandleTraits::Type h
);

Parametry

h
Úchyt.

HandleT::Close

Zavře aktuální HandleT objekt.

void Close();

Poznámky

Popisovač, který je základem aktuálního stavu HandleT , je uzavřen a HandleT je nastaven na neplatný stav.

Pokud se popisovač nezavře správně, vyvolá se ve volajícím vlákně výjimka.

HandleT::D etach

Oddružuje aktuální HandleT objekt od jeho podkladového popisovače.

typename HandleTraits::Type Detach();

Návratová hodnota

Podkladový popisovač.

Poznámky

Po dokončení této operace je aktuální HandleT nastaven na neplatný stav.

HandleT::Get

Získá hodnotu podkladového popisovače.

typename HandleTraits::Type Get() const;

Návratová hodnota

Úchyt.

HandleT::handle_

Obsahuje popisovač, který je reprezentován objektem HandleT .

typename HandleTraits::Type handle_;

HandleT::HandleT

Inicializuje novou instanci HandleT třídy.

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

HandleT(
   _Inout_ HandleT&& h
);

Parametry

h
Úchyt.

Poznámky

První konstruktor inicializuje HandleT objekt, který není platným popisovačem objektu. Druhý konstruktor vytvoří nový HandleT objekt z parametru h.

HandleT::InternalClose

Zavře aktuální HandleT objekt.

virtual bool InternalClose();

Návratová hodnota

true je-li aktuální HandleT uzavřen úspěšně; v opačném případě false.

Poznámky

InternalClose() je protected.

HandleT::IsValid

Určuje, zda aktuální HandleT objekt představuje popisovač.

bool IsValid() const;

Návratová hodnota

trueHandleT pokud představuje popisovač; falsev opačném případě .

HandleT::operator=

Přesune hodnotu zadaného HandleT objektu do aktuálního HandleT objektu.

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

Parametry

h
Odkaz rvalue na popisovač.

Návratová hodnota

Odkaz na aktuální HandleT objekt.

Poznámky

Tato operace zneplatní HandleT objekt určený parametrem h.