Classe ComPtr
Cria um ponteiro inteligente tipo que representa a interface especificada pelo parâmetro de modelo.ComPtr automaticamente mantém uma contagem de referência para o ponteiro de interface subjacente e libera a interface quando a contagem de referência vai a zero.
template <
typename T
>
class ComPtr;
template<
class U
>
friend class ComPtr;
Parâmetros
T
A interface representando o ComPtr.U
Uma classe à qual o ComPtr atual é um amigo.(O modelo que usa esse parâmetro é protegido).
Comentários
< > De ComPtr declara um tipo que representa o ponteiro de interface subjacente.Use < de > ComPtr para declarar uma variável e, em seguida, use o operador de acesso de membro de seta (->) para acessar uma função de membro de interface.
Para obter mais informações sobre os apontadores inteligentes, consulte a subseção "COM a apontadores inteligentes" a COM Coding Practices o Biblioteca MSDN tópico.
Membros
Definições de tipo públicas
Nome |
Descrição |
---|---|
InterfaceType |
Um sinônimo para o tipo especificado pelo T parâmetro do modelo. |
Construtores públicos
Nome |
Descrição |
---|---|
Intializes uma nova instância da classe ComPtr.Sobrecargas fornecem construtores padrão, copiar, mover e conversão. |
|
Deinitializes uma instância de ComPtr. |
Métodos públicos
Nome |
Descrição |
---|---|
Retorna um objeto ComPtr que representa a interface identificada pelo parâmetro do modelo especificado. |
|
Retorna um objeto ComPtr que representa a interface identificada pela identificação da interface especificada. |
|
Recupera uma referência fraca para o objeto atual. |
|
Associa esse ComPtr o tipo de interface especificado pelo parâmetro de tipo de modelo atual. |
|
Copia a interface atual ou especificada associada a esta ComPtr do ponteiro de saída especificado. |
|
Desassocia esta ComPtr da interface que ele representa. |
|
Recupera um ponteiro para a interface que está associado esta ComPtr. |
|
Recupera o endereço da ptr_ o membro de dados, que contém um ponteiro para a interface representado por este ComPtr. |
|
Libera a interface associada a esta ComPtr e, em seguida, recupera o endereço da ptr_ o membro de dados, que contém um ponteiro para a interface que foi lançada. |
|
Troca a interface gerenciada pelo ComPtr atual com a interface gerenciada pelo ComPtr especificado. |
Métodos protegidos
Nome |
Descrição |
---|---|
Incrementa a contagem de referência da interface associada a esta ComPtr. |
|
Executa uma operação COM lançamento na interface associada a esta ComPtr. |
Operadores públicos
Nome |
Descrição |
---|---|
Operador de Microsoft::WRL::Details::BoolType de ComPtr::operator |
Indica se ou não uma ComPtr está gerenciando o tempo de vida do objeto de uma interface. |
Recupera o endereço da ComPtr atual. |
|
Atribui um valor para o ComPtr atual. |
|
Recupera um ponteiro para o tipo especificado pelo parâmetro do modelo atual. |
|
Indica se os dois objetos ComPtr são iguais. |
|
Indica se os dois objetos ComPtr não são iguais. |
Membros de dados protegidos
Nome |
Descrição |
---|---|
Contém um ponteiro para a interface que está associado e gerenciado por este ComPtr. |
Hierarquia de herança
ComPtr
Requisitos
Cabeçalho: client.h
Namespace: Microsoft::WRL