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-