Freigeben über

winrt::try_create_instance Funktionsvorlage (C++/WinRT)

  • Artikel

Eine Funktionsvorlage, die ein einzelnes nicht initialisiertes Objekt der Klasse erstellt, die einer angegebenen CLSID zugeordnet ist, und gibt ihn als winrt::com_ptr oder ein leeres com_ptr zurück, wenn nicht erfolgreich.

Syntax

template <typename Interface>
winrt::com_ptr<Interface> try_create_instance(guid const& clsid,
    uint32_t context = 0x1 /*CLSCTX_INPROC_SERVER*/,
    void* outer = nullptr);

Vorlagenparameter

typename Interface Der Typ des Schnittstellenzeigers, der auf dem neu erstellten Objekt abfraget.

Parameter

clsid Die CLSID, die den Daten und Code zugeordnet ist, die zum Erstellen des Objekts verwendet werden.

context Kontext, in dem der Code, der das neu erstellte Objekt verwaltet, ausgeführt wird. Die Werte werden aus der Enumeration CLSCTX entnommen.

outer Wenn nullptr, gibt an, dass das Objekt nicht als Teil eines Aggregats erstellt wird. Wenn nicht nullptr, wird ein Zeiger auf die IUnknown-Schnittstelle des Aggregatobjekts (das Steuern von IUnknown) angezeigt.

Rückgabewert

Ein Winrt::com_ptr des neu erstellten Objekts oder eines leeren com_ptr wenn nicht erfolgreich.

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)

Siehe auch