RoActivateInstance, fonction (roapi.h)

Active la classe Windows Runtime spécifiée.

Syntaxe

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

Paramètres

[in] activatableClassId

Type : HSTRING

Identificateur de classe associé à la classe runtime activable.

[out] instance

Type : IInspectable**

Pointeur vers le instance activé de la classe runtime.

Valeur retournée

Type : HRESULT

Cette fonction peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
La classe a été activée avec succès.
E_POINTER
instance a la valeur NULL.
CO_E_NOTINITIALIZED
Le thread n’a pas été initialisé dans le Windows Runtime en appelant la fonction RoInitialize.
E_ACCESSDENIED
Le TrustLevel de la classe nécessite un processus de confiance totale.
E_NOINTERFACE
L’interface IInspectable n’est pas implémentée par la classe spécifiée.
E_OUTOFMEMORY
Échec de la création d’un instance de la classe .

Remarques

Utilisez la fonction RoActivateInstance pour activer une classe Windows Runtime. La fonction RoActivateInstance se connecte à la fabrique d’activation associée à l’identificateur de classe activable spécifié, crée un instance en appelant le constructeur d’argument zéro sur la classe et libère la fabrique d’activation.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête roapi.h

Voir aussi

CoCreateInstance

IActivationFactory

IInspectable

TrustLevel