RoActivateInstance-Funktion (roapi.h)

Artikel
03/01/2024

Aktiviert die angegebene Windows-Runtime-Klasse.

Syntax

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

Parameter

[in] activatableClassId

Typ: HSTRING

Der Klassenbezeichner, der der aktivierbaren Laufzeitklasse zugeordnet ist.

[out] instance

Typ: IInspectable**

Ein Zeiger auf den aktivierten instance der Laufzeitklasse.

Rückgabewert

Typ: HRESULT

Diese Funktion kann einen dieser Werte zurückgeben.

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

Hinweise

Verwenden Sie die RoActivateInstance-Funktion, um eine Windows-Runtime-Klasse zu aktivieren. Die RoActivateInstance-Funktion stellt eine Verbindung mit der Aktivierungsfactory her, die dem angegebenen aktivierungsfähigen Klassenbezeichner zugeordnet ist, erstellt eine instance, indem sie den Nullargumentkonstruktor für die Klasse aufruft, und gibt die Aktivierungsfactory frei.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	roapi.h

Weitere Informationen