HandleT (classe)

Représente un handle à un objet.

Syntaxe

template <typename HandleTraits>
class HandleT;

Paramètres

HandleTraits
Instance de la structure HandleTraits qui définit les caractéristiques courantes d’un handle.

Membres

Typedefs publics

Nom	Description
Traits	Synonyme de HandleTraits.

Constructeurs publics

Nom	Description
HandleT ::HandleT	Initialise une nouvelle instance de la classe HandleT.
HandleT ::~HandleT	Désinitialise une instance de la HandleT classe.

Méthodes publiques

Nom	Description
HandleT ::Attach	Associe le handle spécifié à l’objet actif HandleT .
HandleT ::Close	Ferme l’objet actuel HandleT .
HandleT ::D etach	Dissocie l’objet actuel HandleT de son handle sous-jacent.
HandleT ::Get	Obtient la valeur du handle sous-jacent.
HandleT ::IsValid	Indique si l’objet actuel HandleT représente un handle.

Méthodes protégées

Nom	Description
HandleT ::InternalClose	Ferme l’objet actuel HandleT .

Opérateurs publics

Nom	Description
HandleT ::operator=	Déplace la valeur de l’objet spécifié HandleT vers l’objet actif HandleT .

Membres de données protégés

Nom	Description
HandleT ::handle_	Contient le handle représenté par l’objet HandleT .

Hiérarchie d'héritage

HandleT

Spécifications

En-tête : corewrappers.h

Espace de noms : Microsoft ::WRL ::Wrappers

HandleT ::~HandleT

Désinitialise une instance de la HandleT classe.

~HandleT();

HandleT ::Attach

Associe le handle spécifié à l’objet actif HandleT .

void Attach(
   typename HandleTraits::Type h
);

Paramètres

h
Un handle.

HandleT ::Close

Ferme l’objet actuel HandleT .

void Close();

Notes

Handle qui sous-tend le courant HandleT est fermé et est HandleT défini sur l’état non valide.

Si le handle ne se ferme pas correctement, une exception est levée dans le thread appelant.

HandleT ::D etach

Dissocie l’objet actuel HandleT de son handle sous-jacent.

typename HandleTraits::Type Detach();

Valeur de retour

Handle sous-jacent.

Notes

Une fois cette opération terminée, l’état actuel HandleT est défini sur l’état non valide.

HandleT ::Get

Obtient la valeur du handle sous-jacent.

typename HandleTraits::Type Get() const;

Valeur de retour

Un handle.

HandleT ::handle_

Contient le handle représenté par l’objet HandleT .

typename HandleTraits::Type handle_;

HandleT ::HandleT

Initialise une nouvelle instance de la classe HandleT.

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

HandleT(
   _Inout_ HandleT&& h
);

Paramètres

h
Un handle.

Notes

Le premier constructeur initialise un HandleT objet qui n’est pas un handle valide pour un objet. Le deuxième constructeur crée un HandleT objet à partir du paramètre h.

HandleT ::InternalClose

Ferme l’objet actuel HandleT .

virtual bool InternalClose();

Valeur de retour

true si le courant HandleT est fermé avec succès ; sinon, false.

Notes

InternalClose() est protected.

HandleT ::IsValid

Indique si l’objet actuel HandleT représente un handle.

bool IsValid() const;

Valeur de retour

true si le HandleT représente un handle ; sinon, false.

HandleT ::operator=

Déplace la valeur de l’objet spécifié HandleT vers l’objet actif HandleT .

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

Paramètres

h
Référence rvalue à un handle.

Valeur de retour

Référence à l’objet actuel HandleT .

Notes

Cette opération invalide l’objet HandleT spécifié par le paramètre h.