Partilhar via

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

  • Artigo

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

Nota

Você pode definir suas próprias características de identificador (por exemplo, handle_traits ou file_handle_traits em \cppwinrt\winrt\base.h) e usá-las com winrt::handle_type como typename T. Copie um desses exemplos de base.h em seu próprio arquivo de código-fonte e forneça seu próprio tipo de identificador e implementação. Há mais detalhes no artigo da Revista MSDN Windows comC++.

Sintaxe

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 mínimo com suporte: SDK do Windows versão 10.0.17134.0 (Windows 10, versão 1803)

Namespace : winrt

Cabeçalho : %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\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 typename T::type, em que T é o parâmetro de modelo typename T.

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
de função handle_type::attach Anexa a um valor de identificador e assume a propriedade dele.
de função handle_type::close Fecha o identificador subjacente.
função handle_type::d etach Desanexa do identificador subjacente.
handle_type::obter de função Retorna o identificador subjacente caso seja necessário passá-lo para uma função.
de 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 de membro

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

Funções gratuitas

Função Descrição
função de troca 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.

Sintaxe

void close() noexcept;

Função handle_type::d etach

Desanexa do identificador subjacente.

Sintaxe

handle_type::type detach() noexcept;

Valor de retorno

O identificador subjacente anteriormente representado pelo objeto handle_type.

Função handle_type::get

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

Sintaxe

handle_type::type get() const noexcept;

Valor de retorno

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 de retorno

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

handle_type::operator bool

Verifica se o objeto handle_type atualmente representa um identificador válido.

Sintaxe

explicit operator bool() const noexcept;

Valor de retorno

true se o objeto handle_type atualmente representar 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 de retorno

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

left right um valor handle_type cujo identificador deve ser alternado mutuamente com o do outro parâmetro.

Consulte também