WinRT:: weak_ref struct-VorlageC++(/WinRT)winrt::weak_ref struct template (C++/WinRT)

Ein Typ, der einen schwachen Verweis auf ein C++/WinRT -Objekt oder eine-Schnittstelle darstellt.A type representing a weak reference to a C++/WinRT object or interface. Weitere Informationen und Codebeispiele findest du unter Starke und schwache Verweise in C++/WinRT.For more info, and code examples, see Strong and weak references in C++/WinRT.

SyntaxSyntax

template <typename T>
struct weak_ref

VorlagenparameterTemplate parameters

typename T den Typ des C++/WinRT-Objekts oder der-Schnittstelle ein schwacher Verweis auf, der durch das weak_ref -Objekt dargestellt wird.typename T The type of C++/WinRT object or interface a weak reference to which is represented by the weak_ref object. Dies ist der Typ des Ziels des schwachen Verweises.This is the type of the weak reference's target.

VoraussetzungenRequirements

Mindestens unterstütztes SDK: Windows SDK Version 10.0.17134.0 (Windows 10, Version 1803)Minimum supported SDK: Windows SDK version 10.0.17134.0 (Windows 10, version 1803)

Namespace: WinRTNamespace: winrt

Header % WindowsSdkDir% include<windowstargetplatformversion > \cppwinrt\winrt\base.h (standardmäßig eingeschlossen)Header %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (included by default)

KonstruktorenConstructors

KonstruktorConstructor BeschreibungDescription
weak_ref:: weak_ref-Konstruktorweak_ref::weak_ref constructor Initialisiert eine neue Instanz der weak_ref Struktur, optional mit einer Kopie der Eingabedaten.Initializes a new instance of the weak_ref struct, optionally with a copy of the input data.

MemberfunktionenMember functions

FunktionFunction BeschreibungDescription
weak_ref:: Get-Funktionweak_ref::get function Erhöht den Verweis Zähler und ruft das/WinRT- C++Objekt oder die Schnittstelle ab, auf die vom weak_ref Objekt schwach verwiesen wird.Increments the reference count and retrieves the C++/WinRT object or interface weakly referenced by the weak_ref object.

Member-OperatorenMember operators

OperatorOperator BeschreibungDescription
weak_ref:: Operator boolweak_ref::operator bool Überprüft, ob das weak_ref Objekt auf ein C++/WinRT-Objekt abzielt, das noch nicht zerstört wurde.Checks whether the weak_ref object is targeting a C++/WinRT object that hasn't yet been destroyed.

weak_ref:: weak_ref-Konstruktorweak_ref::weak_ref constructor

Initialisiert eine neue Instanz der weak_ref Struktur, optional mit einer Kopie der Eingabedaten.Initializes a new instance of the weak_ref struct, optionally with a copy of the input data.

SyntaxSyntax

weak_ref(std::nullptr_t = nullptr) noexcept;
weak_ref(T const& object);
weak_ref(com_ptr<T> const& object);

ParameterParameters

object ein C++/WinRT-Objekt oder eine Schnittstelle oder einen intelligenten Zeiger, der das weak_ref Objekt initialisiert.object A C++/WinRT object or interface or smart pointer that initializes the weak_ref object.

weak_ref:: Get-Funktionweak_ref::get function

Erhöht den Verweis Zähler und ruft das/WinRT- C++Objekt oder die Schnittstelle ab, auf die vom weak_ref Objekt schwach verwiesen wird.Increments the reference count and retrieves the C++/WinRT object or interface weakly referenced by the weak_ref object.

SyntaxSyntax

auto get() const noexcept;

RückgabewertReturn value

Das C++/WinRT-Objekt oder die Schnittstelle, auf die vom weak_ref Objekt schwach verwiesen wird, oder nullptr, wenn das Ziel des schwachen Verweises zerstört wurde.The C++/WinRT object or interface weakly referenced by the weak_ref object, or nullptr if the weak reference's target has been destroyed.

weak_ref:: Operator boolweak_ref::operator bool

Überprüft, ob das weak_ref Objekt auf ein C++/WinRT-Objekt abzielt, das noch nicht zerstört wurde.Checks whether the weak_ref object is targeting a C++/WinRT object that hasn't yet been destroyed.

SyntaxSyntax

explicit operator bool() const noexcept;

RückgabewertReturn value

true, wenn das weak_ref Objekt für ein C++/WinRT-Objekt steht, das noch nicht zerstört wurde, andernfalls false.true if the weak_ref object is targeting a C++/WinRT object that hasn't yet been destroyed, otherwise false.

Siehe auchSee also