Freigeben über

winrt::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 sie als winrt::com_ptr zurück oder löst es aus, wenn dies nicht erfolgreich ist.

Syntax

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

Vorlagenparameter

typename Interface Der Typ des Schnittstellenzeigers, nach dem das neu erstellte Objekt gesucht werden soll.

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, zeigt ein Zeiger auf die IUnknown-Schnittstelle des Aggregatobjekts (das Steuern von IUnknown).

Rückgabewert

Winrt::com_ptr des neu erstellten Objekts. Wird ausgelöst, wenn sie nicht erfolgreich ist.

Anforderungen

Mindest unterstütztes 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