Freigeben über


RoActivateInstance-Funktion (roapi.h)

Aktiviert die angegebene Windows-Runtime-Klasse.

Syntax

HRESULT RoActivateInstance(
  [in]  HSTRING      activatableClassId,
  [out] IInspectable **instance
);

Die Parameter

[in] activatableClassId

Typ: HSTRING

Der Klassenbezeichner, der der aktivierbaren Laufzeitklasse zugeordnet ist.

[out] instance

Typ: IInspectable**

Ein Zeiger auf die aktivierte Instanz der Laufzeitklasse.

Rückgabewert

Typ: HRESULT-

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode Description
S_OK
Die Klasse wurde erfolgreich aktiviert.
E_POINTER
Instanz ist NULL.
CO_E_NOTINITIALIZED
Der Thread wurde in der Windows-Runtime nicht durch Aufrufen der RoInitialize-Funktion initialisiert.
E_ACCESSDENIED
Der TrustLevel für die Klasse erfordert einen voll vertrauenswürdigen Prozess.
E_NOINTERFACE
Die IInspectable-Schnittstelle wird von der angegebenen Klasse nicht implementiert.
E_OUTOFMEMORY
Fehler beim Erstellen einer Instanz der Klasse.

Bemerkungen

Verwenden Sie die RoActivateInstance-Funktion , um eine Windows-Runtime-Klasse zu aktivieren. Die RoActivateInstance-Funktion stellt eine Verbindung mit der Aktivierungsfactory, die dem angegebenen aktivierbaren Klassenbezeichner zugeordnet ist, eine Instanz durch Aufrufen des Nullargumentkonstruktors für die Klasse erstellt und die Aktivierungsfactory frei.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 8 [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Fenster
Header roapi.h
Library mincore.lib

Siehe auch

CoCreateInstance-

IActivationFactory-

IInspectable

TrustLevel-