winrt::agile_ref-Strukturvorlage (C++/WinRT)
Ein Typ, der einen agilen Verweis auf ein C++/WinRT-Objekt oder eine Schnittstelle darstellt. Weitere Informationen und Codebeispiele finden Sie unter Agile-Objekte in C++/WinRT.
Syntax
template <typename T>
struct agile_ref
Vorlagenparameter
typename T Der Typ von C++/WinRT-Objekt oder schnittstelle einen agilen Verweis, der durch das agile_ref-Objekt dargestellt wird. Dies ist der Typ des agilen Referenzziels.
Anforderungen
Mindest unterstützte SDK: Windows SDK Version 10.0.17134.0 (Windows 10, Version 1803)
Namespace: winrt
Header: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (standardmäßig enthalten)
Konstruktoren
| Konstruktor | BESCHREIBUNG |
|---|---|
| agile_ref::agile_ref Konstruktor | Initialisiert eine neue Instanz der agile_ref-Struktur , optional mit einer Kopie der Eingabedaten. |
Memberfunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| agile_ref::get-Funktion | Ruft einen Proxy zum Ziel des agile_ref-Objekts ab, das sicher innerhalb eines Threadkontexts verwendet werden kann, in dem get aufgerufen wird. |
Memberoperatoren
| Operator | BESCHREIBUNG |
|---|---|
| agile_ref::Operator bool | Überprüft, ob das agile_ref-Objekt auf ein C++/WinRT-Objekt ausgerichtet ist. |
agile_ref::agile_ref Konstruktor
Initialisiert eine neue Instanz der agile_ref-Struktur , optional mit einer Kopie der Eingabedaten.
Syntax
agile_ref(std::nullptr_t = nullptr) noexcept;
agile_ref(T const& object);
Parameter
object Ein C++/WinRT-Objekt oder eine Schnittstelle, die das agile_ref-Objekt initialisiert.
agile_ref::get-Funktion
Ruft einen Proxy zum Ziel des agile_ref-Objekts ab, das sicher innerhalb eines Threadkontexts verwendet werden kann, in dem get aufgerufen wird.
Syntax
T get() const;
Rückgabewert
Ein Proxy an das C++/WinRT-Objekt oder die Schnittstelle, auf die vom agile_ref-Objekt verwiesen wird.
agile_ref::Operator bool
Überprüft, ob das agile_ref-Objekt auf ein gültiges C++/WinRT-Objekt oder eine gültige Schnittstelle ausgerichtet ist.
Syntax
explicit operator bool() const noexcept;
Rückgabewert
true wenn das agile_ref-Objekt über ein gültiges Ziel verfügt, andernfalls false.