HandleT (clase)

Representa un identificador de un objeto.

Sintaxis

template <typename HandleTraits>
class HandleT;

Parámetros

HandleTraits
Instancia de la estructura HandleTraits que define las características comunes de un identificador.

Miembros

Definiciones de tipos públicas

Nombre	Descripción
Traits	Sinónimo de HandleTraits.

Constructores públicos

Nombre	Descripción
HandleT::HandleT	Inicializa una nueva instancia de la clase HandleT.
HandleT::~HandleT	Desinicializa una instancia de la clase HandleT.

Métodos públicos

Nombre	Descripción
HandleT::Attach	Asocia el identificador especificado al objeto HandleT actual.
HandleT::Close	Cierra el actual objeto HandleT.
HandleT::Detach	Desasocia el objeto HandleT actual de su identificador subyacente.
HandleT::Get	Obtiene el valor de identificador subyacente.
HandleT::IsValid	Indica si el objeto HandleT actual representa un identificador.

Métodos protegidos

Nombre	Descripción
HandleT::InternalClose	Cierra el actual objeto HandleT.

Operadores públicos

Nombre	Descripción
HandleT::operator=	Mueve el valor del objeto HandleT especificado al objeto HandleT actual.

Miembros de datos protegidos

Nombre	Descripción
HandleT::handle_	Contiene el identificador representado por el objeto HandleT.

Jerarquía de herencia

HandleT

Requisitos

Encabezado: corewrappers.h

Espacio de nombres: Microsoft::WRL::Wrappers

HandleT::~HandleT

Desinicializa una instancia de la clase HandleT.

~HandleT();

HandleT::Attach

Asocia el identificador especificado al objeto HandleT actual.

void Attach(
   typename HandleTraits::Type h
);

Parámetros

h
Un identificador.

HandleT::Close

Cierra el actual objeto HandleT.

void Close();

Comentarios

El identificador que subyace al objeto HandleT actual está cerrado y HandleT se establece en el estado no válido.

Si el identificador no se cierra correctamente, se genera una excepción en el subproceso que realiza la llamada.

HandleT::Detach

Desasocia el objeto HandleT actual de su identificador subyacente.

typename HandleTraits::Type Detach();

Valor devuelto

El identificador subyacente.

Comentarios

Cuando se completa esta operación, el objeto HandleT actual se establece en el estado no válido.

HandleT::Get

Obtiene el valor de identificador subyacente.

typename HandleTraits::Type Get() const;

Valor devuelto

Un identificador.

HandleT::handle_

Contiene el identificador representado por el objeto HandleT.

typename HandleTraits::Type handle_;

HandleT::HandleT

Inicializa una nueva instancia de la clase HandleT.

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

HandleT(
   _Inout_ HandleT&& h
);

Parámetros

h
Un identificador.

Comentarios

El primer constructor inicializa un objeto HandleT que no es un identificador válido para un objeto. El segundo constructor crea un nuevo objeto HandleT a partir del parámetro h.

HandleT::InternalClose

Cierra el actual objeto HandleT.

virtual bool InternalClose();

Valor devuelto

true si el objeto HandleT actual se cerró correctamente; de lo contrario, false.

Comentarios

InternalClose() es protected.

HandleT::IsValid

Indica si el objeto HandleT actual representa un identificador.

bool IsValid() const;

Valor devuelto

true si el objeto HandleT representa un identificador; de lo contrario, false.

HandleT::operator=

Mueve el valor del objeto HandleT especificado al objeto HandleT actual.

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

Parámetros

h
Referencia de rvalue a un identificador.

Valor devuelto

Referencia al objeto HandleT actual.

Comentarios

Esta operación invalida el objeto HandleT especificado por el parámetro h.