Share via

Modelo de struct winrt::handle_type (C++/WinRT)

  • Artigo

O modelo para structs winrt::handle e winrt::file_handle , entre outros.

Observação

Você pode definir seus próprios traços de identificador (veja, por exemplo, handle_traits ou file_handle_traits ), \cppwinrt\winrt\base.he usá-los com winrt::handle_type como typename T. Copie um desses exemplos de seu próprio arquivo de base.h código-fonte e forneça seu próprio tipo de identificador e implementação. Há mais detalhes no artigo da Revista MSDN Windows com C++.

Syntax

template <typename T>
struct handle_type

Parâmetros de modelo

typename T Um tipo de característica que especifica o tipo de identificador que está sendo representado (um identificador, um identificador de arquivo ou algum outro tipo).

Requisitos

SDK com suporte mínimo: Windows SDK versão 10.0.17134.0 (Windows 10, versão 1803)

Namespace: winrt

Cabeçalho: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (incluído por padrão)

Aliases de tipo de membro

Nome do alias Tipo
handle_type::type Um sinônimo para o nome de tipo T::type, em que T é o parâmetro de typename T modelo.

Construtores

Construtor Descrição
construtor handle_type::handle_type Inicializa uma nova instância do struct handle_type , opcionalmente com uma cópia ou movimentação dos dados de entrada.

Funções de membro

Função Descrição
função handle_type::attach Anexa a um valor de identificador e assume a propriedade dele.
função handle_type::close Fecha o identificador subjacente.
Função handle_type::d etach Desanexa do identificador subjacente.
função handle_type::get Retorna o identificador subjacente caso precise passá-lo para uma função.
Função handle_type::p ut Retorna o endereço do identificador subjacente; essa função ajuda você a chamar métodos que retornam referências como parâmetros out por meio de um ponteiro para um identificador.

Operadores membros

Operador Descrição
handle_type::operador bool Verifica se o objeto handle_type representa ou não um identificador válido no momento.
handle_type::operator= (operador de atribuição) Atribui um valor ao objeto handle_type .

Funções gratuitas

Função Descrição
função swap Troca o conteúdo dos dois parâmetros handle_type para que eles contenham o identificador um do outro.

construtor handle_type::handle_type

Inicializa uma nova instância do struct handle_type , opcionalmente com uma cópia ou movimentação dos dados de entrada.

Sintaxe

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

Parâmetros

value Um valor que inicializa o objeto handle_type .

other Outro handle_type que inicializa o objeto handle_type .

função handle_type::attach

Anexa a um valor de identificador e assume a propriedade dele.

Sintaxe

void attach(handle_type::type value) noexcept;

Parâmetros

value Um valor de identificador a ser anexado.

função handle_type::close

Fecha o identificador subjacente.

Syntax

void close() noexcept;

Função handle_type::d etach

Desanexa do identificador subjacente.

Sintaxe

handle_type::type detach() noexcept;

Valor retornado

O identificador subjacente anteriormente representado pelo objeto handle_type .

função handle_type::get

Retorna o identificador subjacente, caso precise passá-lo para uma função.

Sintaxe

handle_type::type get() const noexcept;

Valor retornado

O identificador subjacente representado pelo objeto handle_type .

Função handle_type::p ut

Retorna o endereço do identificador subjacente; essa função ajuda você a chamar métodos que retornam referências como parâmetros out por meio de um ponteiro para um identificador.

Sintaxe

handle_type::type* put() noexcept;

Valor retornado

O endereço do identificador subjacente representado pelo objeto handle_type .

handle_type::operador bool

Verifica se o objeto handle_type representa ou não um identificador válido no momento.

Sintaxe

explicit operator bool() const noexcept;

Valor retornado

true se o objeto handle_type atualmente representa um identificador válido, caso contrário false.

handle_type::operator= (operador de atribuição)

Atribui um valor ao objeto handle_type .

Sintaxe

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

Parâmetros

other Um valor handle_type a ser atribuído ao objeto handle_type .

Valor retornado

Uma referência ao objeto handle_type .

função swap

Troca o conteúdo dos dois parâmetros handle_type para que eles contenham o identificador um do outro.

Sintaxe

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

Parâmetros

leftright Um valor handle_type cujo identificador deve ser alternado mutuamente com o do outro parâmetro.

Confira também