Partilhar via


Classe WeakReference

Oferece suporte à infraestrutura de WRL e não deve ser usado diretamente no seu código.

class WeakReference;

Comentários

Representa uma referência de URL que pode ser usada com tempos de Execução do Windows ou COM clássico. Uma referência de objeto representa um que pode ou não ser acessível.

Um objeto de WeakReference mantém uma referência forte, que é um ponteiro para um objeto, e uma contagem forte de referência, que é o número de cópias de referência forte que foram distribuídas pelo método de resolução (). Quando a contagem forte de referência seja diferente de zero, a referência forte é válido e o objeto está acessível. Quando a contagem de referência forte se tornará zero, a referência forte não é válida e o objeto está inacessível.

Um objeto de WeakReference normalmente é usado para representar um objeto cuja existente é controlada por um thread ou por um aplicativo externo. Por exemplo, construir um objeto de WeakReference 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.

Os métodos de WeakReference são thread-safe.

Membros

Construtores Públicos

Nome

Descrição

Construtor WeakReference::WeakReference

Inicializa uma nova instância da classe de WeakReference.

Destruidor WeakReference::~WeakReference

Deinitializes (destruir) a instância atual da classe de WeakReference.

Métodos Públicos

Nome

Descrição

Método WeakReference::DecrementStrongReference

Forte do diminuirá a contagem de referência do objeto atual de WeakReference.

Método WeakReference::IncrementStrongReference

Forte incrementa a contagem de referência do objeto atual de WeakReference.

Método WeakReference::Resolve

Define o ponteiro especificado ao valor de referência forte atual se a contagem forte de referência for diferente de zero.

Método WeakReference::SetUnknown

Define a referência forte do objeto atual de WeakReference especificado para o ponteiro da interface.

Hierarquia de Herança

WeakReference

Requisitos

Cabeçalho: implements.h

Namespace: Microsoft::WRL::Details

Consulte também

Referência

Namespace Microsoft::WRL::Details