Compartir a través de

Plantilla de estructura winrt::handle_type (C++/WinRT)

  • Artículo

Plantilla para los winrt::handle y structs winrt::file_handle, entre otros.

Nota

Puede definir sus propios rasgos de identificador (vea, por ejemplo, handle_traits o file_handle_traits en \cppwinrt\winrt\base.h), y usarlos con winrt::handle_type como typename T. Copie uno de esos ejemplos de base.h en su propio archivo de código fuente y proporcione su propio tipo de identificador e implementación. Hay más detalles en el artículo de MSDN Magazine Windows con C++.

Sintaxis

template <typename T>
struct handle_type

Parámetros de plantilla

typename T tipo de rasgos que especifica el tipo de identificador que se representa (un identificador, un identificador de archivo o algún otro tipo).

Requisitos

SDK mínimo admitido: Windows SDK versión 10.0.17134.0 (Windows 10, versión 1803)

Namespace: winrt

encabezado : %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (incluido de forma predeterminada)

Alias de tipo de miembro

Nombre del alias Tipo
handle_type::type Sinónimo de typename T::type, donde T es el parámetro de plantilla de typename T.

Constructores

Constructor Descripción
handle_type::handle_type constructor Inicializa una nueva instancia de la estructura de handle_type, opcionalmente con una copia o movimiento de los datos de entrada.

Funciones miembro

Función Descripción
de función handle_type::attach Se asocia a un valor de identificador y toma posesión de él.
handle_type::close de función Cierra el identificador subyacente.
función handle_type::d etach Se desasocia del identificador subyacente.
handle_type::get function Devuelve el identificador subyacente si necesita pasarlo a una función.
de función handle_type::p ut Devuelve la dirección del identificador subyacente; esta función le ayuda a llamar a métodos que devuelven referencias como parámetros out a través de un puntero a un identificador.

Operadores de miembro

Operador Descripción
handle_type::operator bool Comprueba si el objeto handle_type representa actualmente un identificador válido.
handle_type::operator= (operador de asignación) Asigna un valor al objeto handle_type.

Funciones gratuitas

Función Descripción
función de intercambio Intercambia el contenido de los dos parámetros handle_type para que contengan el identificador del otro.

constructor handle_type::handle_type

Inicializa una nueva instancia de la estructura de handle_type, opcionalmente con una copia o movimiento de los datos de entrada.

Sintaxis

handle_type() noexcept;
explicit handle_type(handle_type::type value) noexcept;
handle_type(handle_type&& other) noexcept;

Parámetros

value Valor que inicializa el objeto handle_type.

other Otro handle_type que inicializa el objeto handle_type.

función handle_type::attach

Se asocia a un valor de identificador y toma posesión de él.

Sintaxis

void attach(handle_type::type value) noexcept;

Parámetros

value valor de identificador al que se va a asociar.

handle_type::close (función)

Cierra el identificador subyacente.

Sintaxis

void close() noexcept;

función handle_type::d etach

Se desasocia del identificador subyacente.

Sintaxis

handle_type::type detach() noexcept;

Valor devuelto

Identificador subyacente representado anteriormente por el objeto handle_type.

handle_type::get (función)

Devuelve el identificador subyacente, si necesita pasarlo a una función.

Sintaxis

handle_type::type get() const noexcept;

Valor devuelto

Identificador subyacente representado por el objeto handle_type.

función handle_type::p ut

Devuelve la dirección del identificador subyacente; esta función le ayuda a llamar a métodos que devuelven referencias como parámetros out a través de un puntero a un identificador.

Sintaxis

handle_type::type* put() noexcept;

Valor devuelto

Dirección del identificador subyacente representado por el objeto handle_type.

handle_type::operator bool

Comprueba si el objeto handle_type representa actualmente un identificador válido.

Sintaxis

explicit operator bool() const noexcept;

Valor devuelto

true si el objeto handle_type representa actualmente un identificador válido; de lo contrario, false.

handle_type::operator= (operador de asignación)

Asigna un valor al objeto handle_type.

Sintaxis

winrt::handle_type& operator=(winrt::handle_type&& other) noexcept;

Parámetros

other Valor de handle_type que se va a asignar al objeto handle_type.

Valor devuelto

Referencia al objeto handle_type.

función swap

Intercambia el contenido de los dos parámetros handle_type para que contengan el identificador del otro.

Sintaxis

void swap(winrt::handle_type& left, winrt::handle_type& right) noexcept;

Parámetros

left right valor de handle_type cuyo identificador se va a intercambiar mutuamente con el del otro parámetro.

Consulte también