Partager via


RoInitialize, fonction (roapi.h)

Initialise 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 Descriptif
S_OK
Windows Runtime a été initialisé avec succès sur ce thread.
S_FALSE
Windows Runtime est déjà initialisé sur ce thread.
RPC_E_CHANGED_MODE
Un appel précédent à RoInitialize a spécifié le modèle d’accès concurrentiel pour ce thread en tant qu’appartement multithread (MTA). Cela peut également indiquer qu’un changement de l’appartement à threads neutres vers l’appartement à thread unique s’est produit.

Remarques

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

Appelez la fonction RoUninitialize pour fermer 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.

Spécifications

Requirement Valeur
Client minimum requis Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
plateforme cible Fenêtres
Header roapi.h
Library mincore.lib

Voir aussi

CoInitializeEx

RO_INIT_TYPE

RoUninitialize