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

  • Artículo

Plantilla para las estructuras winrt::handle y winrt::file_handle , entre otras.

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 desde 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)

Espacio de nombres: winrt

Encabezado: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (incluido de forma predeterminada)

Alias de tipo de miembro

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

Constructores

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

Funciones miembro

Función Descripción
handle_type::attach (función) Se asocia a un valor de identificador y toma posesión de él.
función handle_type::close Cierra el identificador subyacente.
función handle_type::d etach Desasocia del identificador subyacente.
handle_type::get (función) Devuelve el identificador subyacente si necesita pasarlo a una función.
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

Operator 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 swap Intercambia el contenido de los dos parámetros handle_type para que contengan el identificador de otro.

constructor handle_type::handle_type

Inicializa una nueva instancia de la estructura 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 .

handle_type::attach (función)

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 adjuntar.

función handle_type::close

Cierra el identificador subyacente.

Sintaxis

void close() noexcept;

función handle_type::d etach

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 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 de otro.

Sintaxis

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

Parámetros

leftright Valor de handle_type cuyo identificador se va a intercambiar mutuamente con el del otro parámetro.

Consulte también