Condividi tramite


Funzione RoActivateInstance (roapi.h)

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

Cocreateinstance

IActivationFactory

IInspectable

Trustlevel