HandleT (classe)

Rappresenta un handle per un oggetto .

Sintassi

template <typename HandleTraits>
class HandleT;

Parametri

HandleTraits
Istanza della struttura HandleTraits che definisce le caratteristiche comuni di un handle.

Membri

Typedef pubblici

Nome	Descrizione
Traits	Sinonimo di HandleTraits.

Costruttori pubblici

Nome	Descrizione
HandleT::HandleT	Inizializza una nuova istanza della classe HandleT.
HandleT::~HandleT	Deinitialize un'istanza della HandleT classe .

Metodi pubblici

Nome	Descrizione
HandleT::Attach	Associa l'handle specificato all'oggetto corrente HandleT .
HandleT::Close	Chiude l'oggetto corrente HandleT .
HandleT::D etach	Annulla l'associazione dell'oggetto corrente HandleT dal relativo handle sottostante.
HandleT::Get	Ottiene il valore dell'handle sottostante.
HandleT::IsValid	Indica se l'oggetto corrente HandleT rappresenta un handle.

Metodi protetti

Nome	Descrizione
HandleT::InternalClose	Chiude l'oggetto corrente HandleT .

Operatori pubblici

Nome	Descrizione
HandleT::operator=	Sposta il valore dell'oggetto specificato HandleT nell'oggetto corrente HandleT .

Membri dati protetti

Nome	Descrizione
HandleT::handle_	Contiene l'handle rappresentato dall'oggetto HandleT .

Gerarchia di ereditarietà

HandleT

Requisiti

Intestazione: corewrappers.h

Spazio dei nomi: Microsoft::WRL::Wrappers

HandleT::~HandleT

Deinitialize un'istanza della HandleT classe .

~HandleT();

HandleT::Attach

Associa l'handle specificato all'oggetto corrente HandleT .

void Attach(
   typename HandleTraits::Type h
);

Parametri

h
Handle.

HandleT::Close

Chiude l'oggetto corrente HandleT .

void Close();

Osservazioni:

Handle sottostante l'oggetto corrente HandleT chiuso e HandleT impostato sullo stato non valido.

Se l'handle non viene chiuso correttamente, viene generata un'eccezione nel thread chiamante.

HandleT::D etach

Annulla l'associazione dell'oggetto corrente HandleT dal relativo handle sottostante.

typename HandleTraits::Type Detach();

Valore restituito

Handle sottostante.

Osservazioni:

Al termine dell'operazione, l'oggetto corrente HandleT viene impostato sullo stato non valido.

HandleT::Get

Ottiene il valore dell'handle sottostante.

typename HandleTraits::Type Get() const;

Valore restituito

Handle.

HandleT::handle_

Contiene l'handle rappresentato dall'oggetto HandleT .

typename HandleTraits::Type handle_;

HandleT::HandleT

Inizializza una nuova istanza della classe HandleT.

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

HandleT(
   _Inout_ HandleT&& h
);

Parametri

h
Handle.

Osservazioni:

Il primo costruttore inizializza un HandleT oggetto che non è un handle valido per un oggetto . Il secondo costruttore crea un nuovo HandleT oggetto dal parametro h.

HandleT::InternalClose

Chiude l'oggetto corrente HandleT .

virtual bool InternalClose();

Valore restituito

true se l'oggetto corrente HandleT è stato chiuso correttamente; in caso contrario, false.

Osservazioni:

InternalClose() è .protected

HandleT::IsValid

Indica se l'oggetto corrente HandleT rappresenta un handle.

bool IsValid() const;

Valore restituito

true se rappresenta HandleT un handle; in caso contrario, false.

HandleT::operator=

Sposta il valore dell'oggetto specificato HandleT nell'oggetto corrente HandleT .

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

Parametri

h
Riferimento rvalue a un handle.

Valore restituito

Riferimento all'oggetto corrente HandleT .

Osservazioni:

Questa operazione invalida l'oggetto HandleT specificato dal parametro h.