Funzione RoActivateInstance (roapi.h)

Articolo
08/25/2023

Attiva la classe Windows Runtime specificata.

Sintassi

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

Parametri

[in] activatableClassId

Tipo: HSTRING

Identificatore di classe associato alla classe runtime activatable.

[out] instance

Tipo: IInspectable**

Puntatore all'istanza attivata della classe di runtime.

Valore restituito

Tipo: HRESULT

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	La classe è stata attivata correttamente.
E_POINTER	l'istanza è NULL.
CO_E_NOTINITIALIZED	Il thread non è stato inizializzato nella Windows Runtime chiamando la funzione RoInitialize.
E_ACCESSDENIED	TrustLevel per la classe richiede un processo di trust completo.
E_NOINTERFACE	L'interfaccia IInspectable non viene implementata dalla classe specificata.
E_OUTOFMEMORY	Impossibile creare un'istanza della classe.

Commenti

Usare la funzione RoActivateInstance per attivare una classe Windows Runtime. La funzione RoActivateInstance si connette alla factory di attivazione associata all'identificatore di classe activatable specificato, crea un'istanza chiamando il costruttore zero-argument nella classe e rilascia la factory di attivazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	roapi.h

Vedi anche