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.