Partager via


WeakRef, classe

Représente une référence faible pouvant être utilisée uniquement avec le Windows Runtime, pas le COM classique. Une référence faible représente un objet qui peut être accessible ou non.

class WeakRef : public ComPtr<IWeakReference>

Remarques

Un objet WeakRef conserve une référence forte, qui est associée à un objet, et pouvant être valide ou non valide. Appelez la méthode As() ou AsIID() pour obtenir une référence forte. Lorsque la référence forte est valide, elle peut accéder à l'objet associé. Lorsque la référence forte n'est pas valide (nullptr), l'objet associé est inaccessible.

Un objet WeakRef est généralement utilisé pour représenter un objet dont l'existence est contrôlée par un thread ou une application externe. Par exemple, construisez un objet WeakRef à partir d'une référence à un fichier objet. Lorsque le fichier est ouvert, la référence forte est valide. Mais si le fichier est fermé, la référence forte devient non valide.

Membres

Constructeurs publics

Name

Description

WeakRef::WeakRef, constructeur

Initialise une nouvelle instance de la classe WeakRef.

WeakRef::~WeakRef, destructeur

Libère l'instance actuelle de la classe WeakRef.

Méthodes publiques

Name

Description

WeakRef::As, méthode

Définit le paramètre du pointeur ComPtr spécifié pour représenter l'interface spécifiée.

WeakRef::AsIID, méthode

Définit le paramètre du pointeur ComPtr spécifié pour représenter l'ID d'interface spécifié.

WeakRef::CopyTo, méthode

Assigne un pointeur vers une interface, si disponible, vers la variable du pointeur spécifiée.

Opérateurs publics

Name

Description

WeakRef::operator&, opérateur

Retourne un objet ComPtrRef représentant l'objet WeakRef actuel.

Hiérarchie d'héritage

ComPtr

WeakRef

Configuration requise

En-tête: client.h

Espace de noms: Microsoft::WRL

Voir aussi

Référence

Microsoft::WRL, espace de noms