RoInitialize, fonction (roapi.h)

  • Article

Initialise le Windows Runtime sur le thread actuel avec le modèle d’accès concurrentiel spécifié.

Syntaxe

HRESULT RoInitialize(
  [in] RO_INIT_TYPE initType
);

Paramètres

[in] initType

Type : RO_INIT_TYPE

Modèle d’accès concurrentiel pour le thread. La valeur par défaut est RO_INIT_MULTITHREADED.

Valeur retournée

Type : HRESULT

Cette fonction peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY et E_UNEXPECTED, ainsi que les valeurs suivantes.

Code de retour Description
S_OK
 Le Windows Runtime a été initialisé avec succès sur ce thread.
S_FALSE
 Le Windows Runtime est déjà initialisé sur ce thread.
RPC_E_CHANGED_MODE
 Un appel précédent à RoInitialize spécifiait le modèle d’accès concurrentiel pour ce thread en tant qu’appartement multithread (MTA). Cela peut également indiquer qu’une modification de l’appartement à thread neutre à l’appartement à thread unique s’est produite.

Remarques

Utilisez la fonction RoInitialize pour initialiser un thread dans le Windows Runtime. Tous les threads qui activent des objets Windows Runtime et interagissent avec eux doivent être initialisés avant d’appeler le Windows Runtime.

Appelez la fonction RoUninitialize pour fermer le Windows Runtime sur le thread actuel. Chaque appel réussi à RoInitialize, y compris ceux qui retournent S_FALSE, doit être équilibré par un appel correspondant à RoUninitialize.

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

CoInitializeEx

RO_INIT_TYPE

RoUninitialize