Partilhar via


Classe WeakRef

Representa uma referência de URL que pode ser usada apenas por Tempo de Execução do Windows, a não clássico. Uma referência de objeto representa um que pode ou não ser acessível.

class WeakRef : public ComPtr<IWeakReference>

Comentários

Um objeto de WeakRef mantém uma referência forte, que é associada a um objeto, e pode ser válido ou não é válido. Chame o método de As() ou de AsIID() para obter uma referência forte. Quando a referência forte é válido, o pode acessar o objeto associado. Quando a referência não é válida forte (nullptr), o objeto associado é inacessível.

Um objeto de WeakRef normalmente é usado para representar um objeto cuja existente é controlada por um thread ou por um aplicativo externo. Por exemplo, construir um objeto de WeakRef de uma referência a um objeto de arquivo. Quando o arquivo estiver aberto, a referência forte é válido. Mas se o arquivo é fechado, a referência forte torna-se inválido.

Membros

Construtores Públicos

Nome

Descrição

Construtor WeakRef::WeakRef

Inicializa uma nova instância da classe de WeakRef.

Destruidor WeakRef::~WeakRef

Deinitializes a instância atual da classe de WeakRef.

Métodos Públicos

Nome

Descrição

Método WeakRef::As

Define o parâmetro especificado do ponteiro de ComPtr para representar a interface especificada.

Método WeakRef::AsIID

Define o parâmetro especificado do ponteiro de ComPtr para representar a ID da interface especificada

Método WeakRef::CopyTo

Atribui um ponteiro para uma interface, se disponível, para a variável de ponteiro especificado.

Operadores Públicos

Nome

Descrição

Operador WeakRef::operator&

Retorna um objeto de ComPtrRef que representa o objeto atual de WeakRef.

Hierarquia de Herança

ComPtr

WeakRef

Requisitos

Cabeçalho: client.h

Namespace: Microsoft::WRL

Consulte também

Referência

Namespace Microsoft::WRL