HandleT-Klasse

Stellt ein Handle für ein Objekt dar.

Syntax

template <typename HandleTraits>
class HandleT;

Parameter

HandleTraits
Eine Instanz der HandleTraits-Struktur , die allgemeine Merkmale eines Handles definiert.

Member

Öffentliche Typedefs

Name	Beschreibung
Traits	Ein Synonym für HandleTraits.

Öffentliche Konstruktoren

Name	Beschreibung
HandleT::HandleT	Initialisiert eine neue Instanz der HandleT-Klasse.
HandleT::~HandleT	Deinitialisiert eine Instanz der HandleT Klasse.

Öffentliche Methoden

Name	Beschreibung
HandleT::Attach	Ordnet das angegebene Handle dem aktuellen HandleT Objekt zu.
HandleT::Close	Schließt das aktuelle HandleT Objekt.
HandleT::D etach	Entfernt die Zuordnung des aktuellen HandleT Objekts vom zugrunde liegenden Handle.
HandleT::Get	Ruft den Wert des zugrunde liegenden Handles ab.
HandleT::IsValid	Gibt an, ob das aktuelle HandleT Objekt ein Handle darstellt.

Geschützte Methoden

Name	Beschreibung
HandleT::InternalClose	Schließt das aktuelle HandleT Objekt.

Öffentliche Operatoren

Name	Beschreibung
HandleT::operator=	Verschiebt den Wert des angegebenen HandleT Objekts in das aktuelle HandleT Objekt.

Geschützte Datenmember

Name	Beschreibung
HandleT::handle_	Enthält das Handle, das durch das HandleT Objekt dargestellt wird.

Vererbungshierarchie

HandleT

Anforderungen

Kopfzeile: corewrappers.h

Namespace: Microsoft::WRL::Wrapper

HandleT::~HandleT

Deinitialisiert eine Instanz der HandleT Klasse.

~HandleT();

HandleT::Attach

Ordnet das angegebene Handle dem aktuellen HandleT Objekt zu.

void Attach(
   typename HandleTraits::Type h
);

Parameter

h
Ein Handle.

HandleT::Close

Schließt das aktuelle HandleT Objekt.

void Close();

Hinweise

Das Handle, das den aktuellen HandleT Zustand unterliest, ist geschlossen und HandleT auf den ungültigen Zustand festgelegt.

Wenn das Handle nicht ordnungsgemäß geschlossen wird, wird eine Ausnahme im aufrufenden Thread ausgelöst.

HandleT::D etach

Entfernt die Zuordnung des aktuellen HandleT Objekts vom zugrunde liegenden Handle.

typename HandleTraits::Type Detach();

Rückgabewert

Das zugrunde liegende Handle.

Hinweise

Wenn dieser Vorgang abgeschlossen ist, wird der aktuelle HandleT Zustand auf den ungültigen Zustand festgelegt.

HandleT::Get

Ruft den Wert des zugrunde liegenden Handles ab.

typename HandleTraits::Type Get() const;

Rückgabewert

Ein Handle.

HandleT::handle_

Enthält das Handle, das durch das HandleT Objekt dargestellt wird.

typename HandleTraits::Type handle_;

HandleT::HandleT

Initialisiert eine neue Instanz der HandleT-Klasse.

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

HandleT(
   _Inout_ HandleT&& h
);

Parameter

h
Ein Handle.

Hinweise

Der erste Konstruktor initialisiert ein HandleT Objekt, das kein gültiges Handle für ein Objekt ist. Der zweite Konstruktor erstellt ein neues HandleT Objekt aus Parameter h.

HandleT::InternalClose

Schließt das aktuelle HandleT Objekt.

virtual bool InternalClose();

Rückgabewert

truewenn der aktuelle HandleT Fehler erfolgreich geschlossen wurde; andernfalls . false

Hinweise

InternalClose() ist protected

HandleT::IsValid

Gibt an, ob das aktuelle HandleT Objekt ein Handle darstellt.

bool IsValid() const;

Rückgabewert

truewenn der HandleT Ziehpunkt darstellt; andernfalls . false

HandleT::operator=

Verschiebt den Wert des angegebenen HandleT Objekts in das aktuelle HandleT Objekt.

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

Parameter

h
Ein Wertverweis auf ein Handle.

Rückgabewert

Ein Verweis auf das aktuelle HandleT Objekt.

Hinweise

Durch diesen Vorgang wird das HandleT durch Parameter h angegebene Objekt ungültig.