Freigeben über


WeakRef-Klasse

Stellt einen schwachen Verweis, der auf den nur der Runtime Windows verwendet werden kann, nicht klassisches COM dar. Ein schwacher Verweis stellt ein Objekt dar, das möglicherweise oder möglicherweise nicht möglich ist.

class WeakRef : public ComPtr<IWeakReference>

Hinweise

Ein WeakRef-Objekt verwaltet einen starken Verweis, der mit einem Objekt verknüpft, und kann gültig oder ungültig. Rufen Sie die As() oder AsIID() Methode auf, um einen starken Verweis zu erhalten. Wenn der Verweis starke gültig ist, kann er auf das zugeordnete Objekt zugreifen. Wenn der starke Verweis (nullptr) ungültig ist, ist das zugeordnete Objekt nicht zugegriffen werden.

Ein WeakRef-Objekt wird normalerweise verwendet, um ein Objekt repräsentiert, dessen Vorhandensein von ein externer Thread oder Anwendung gesteuert wird. Erstellen Sie beispielsweise WeakRef-Objekt von einen Verweis auf ein Dateiobjekt. Während die Datei geöffnet wird, wird der starke Verweis gültig. jedoch, wenn die Datei geschlossen wird, wird der starke Verweis ungültig.

Member

Öffentliche Konstruktoren

Name

Beschreibung

WeakRef::WeakRef-Konstruktor

Initialisiert eine neue Instanz der WeakRef-Klasse.

WeakRef::~WeakRef-Destruktor

Deinitialisiert die aktuelle Instanz der WeakRef-Klasse.

Öffentliche Methoden

Name

Beschreibung

WeakRef::As-Methode

Legt den angegebenen ComPtr-Zeigerparameter fest, um die angegebene Schnittstelle darzustellen.

WeakRef::AsIID-Methode

Legt den angegebenen ComPtr-Zeigerparameter fest, um die angegebene Schnittstelle ID darstellt

WeakRef::CopyTo-Methode

Weist einen Zeiger auf eine Schnittstelle zu, falls verfügbar, der angegebenen Zeigervariable.

Öffentliche Operatoren

Name

Beschreibung

WeakRef::operator&-Operator

Gibt einen ComPtrRef-Objekt zurück, die das aktuelle WeakRef-Objekt darstellt.

Vererbungshierarchie

ComPtr

WeakRef

Anforderungen

Header: client.h

Namespace: Microsoft::WRL

Siehe auch

Referenz

Microsoft::WRL-Namespace