HandleT — Klasa

Reprezentuje uchwyt do obiektu.

Składnia

template <typename HandleTraits>
class HandleT;

Parametry

HandleTraits
Wystąpienie struktury HandleTraits , która definiuje typowe cechy uchwytu.

Członkowie

Definicje typów publicznych

Nazwa/nazwisko	opis
Traits	Synonim dla elementu HandleTraits.

Konstruktory publiczne

Nazwa/nazwisko	opis
HandleT::HandleT	Inicjuje nowe wystąpienie klasy HandleT.
HandleT::~HandleT	Deinitializuje wystąpienie HandleT klasy .

Metody publiczne

Nazwa/nazwisko	opis
HandleT::Attach	Kojarzy określony uchwyt z bieżącym HandleT obiektem.
HandleT::Close	Zamyka bieżący HandleT obiekt.
HandleT::D etach	Usuwa skojarzenie bieżącego HandleT obiektu z jego dojścia bazowego.
HandleT::Get	Pobiera wartość bazowego dojścia.
HandleT::IsValid	Wskazuje, czy bieżący HandleT obiekt reprezentuje uchwyt.

Metody chronione

Nazwa/nazwisko	opis
HandleT::InternalClose	Zamyka bieżący HandleT obiekt.

Operatory publiczne

Nazwa/nazwisko	opis
HandleT::operator=	Przenosi wartość określonego HandleT obiektu do bieżącego HandleT obiektu.

Chronione składowe danych

Nazwa/nazwisko	opis
HandleT::handle_	Zawiera uchwyt reprezentowany HandleT przez obiekt.

Hierarchia dziedziczenia

HandleT

Wymagania

Nagłówek: corewrappers.h

Przestrzeń nazw: Microsoft::WRL::Wrappers

HandleT::~HandleT

Deinitializuje wystąpienie HandleT klasy .

~HandleT();

HandleT::Attach

Kojarzy określony uchwyt z bieżącym HandleT obiektem.

void Attach(
   typename HandleTraits::Type h
);

Parametry

h
Uchwyt.

HandleT::Close

Zamyka bieżący HandleT obiekt.

void Close();

Uwagi

Uchwyt, który stanowi podwaliny bieżący HandleT , jest zamknięty, a HandleT właściwość jest ustawiona na nieprawidłowy stan.

Jeśli uchwyt nie zamyka się poprawnie, w wątku wywołującym zostanie zgłoszony wyjątek.

HandleT::D etach

Usuwa skojarzenie bieżącego HandleT obiektu z jego dojścia bazowego.

typename HandleTraits::Type Detach();

Wartość zwracana

Dojście bazowe.

Uwagi

Po zakończeniu tej operacji bieżący HandleT jest ustawiony na nieprawidłowy stan.

HandleT::Get

Pobiera wartość bazowego dojścia.

typename HandleTraits::Type Get() const;

Wartość zwracana

Uchwyt.

HandleT::handle_

Zawiera uchwyt reprezentowany HandleT przez obiekt.

typename HandleTraits::Type handle_;

HandleT::HandleT

Inicjuje nowe wystąpienie klasy HandleT.

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

HandleT(
   _Inout_ HandleT&& h
);

Parametry

h
Uchwyt.

Uwagi

Pierwszy konstruktor inicjuje HandleT obiekt, który nie jest prawidłowym uchwytem dla obiektu. Drugi konstruktor tworzy nowy HandleT obiekt z parametru h.

HandleT::InternalClose

Zamyka bieżący HandleT obiekt.

virtual bool InternalClose();

Wartość zwracana

true jeśli bieżąca wartość HandleT została pomyślnie zamknięta; w przeciwnym razie false.

Uwagi

Parametr InternalClose() ma wartość protected.

HandleT::IsValid

Wskazuje, czy bieżący HandleT obiekt reprezentuje uchwyt.

bool IsValid() const;

Wartość zwracana

true jeśli obiekt HandleT reprezentuje uchwyt; w przeciwnym razie false.

HandleT::operator=

Przenosi wartość określonego HandleT obiektu do bieżącego HandleT obiektu.

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

Parametry

h
Odwołanie rvalue do uchwytu.

Wartość zwracana

Odwołanie do bieżącego HandleT obiektu.

Uwagi

Ta operacja unieważnia HandleT obiekt określony przez parametr h.