Fonction Initialize (roapi.h)

Initialise un thread pour utiliser Windows Runtime API.

Syntaxe

HRESULT Initialize(
  RO_INIT_TYPE initType
);

Paramètres

initType

Spécifie le type d’appartement du thread à initialiser.

Valeur retournée

• S_OK : initialisation réussie pour la première fois sur le thread actuel
• S_FALSE - Initialisation imbriquée réussie (le thread actuel a déjà été initialisé pour le type d’appartement spécifié)
• E_INVALIDARG : valeur initType non valide
• CO_E_INIT_TLS : impossible d’allouer la structure TLS interne de COM
• E_OUTOFMEMORY : impossible d’allouer des structures par thread/par appartement autres que tls
• RPC_E_CHANGED_MODE : le thread actuel est déjà initialisé pour un type d’appartement différent de ce qui est spécifié.

Remarques

Windows ::Foundation ::Initialize est modifié pour créer des ASTA au lieu des STA classiques pour la valeur RO_INIT_TYPERO_INIT_SINGLETHREADED. Windows ::Foundation ::Initialize(RO_INIT_SINGLETHREADED) n’est pas pris en charge pour les applications de bureau et retourne CO_E_NOTSUPPORTED s’il est appelé à partir d’un processus autre qu’une application du Windows Store.

Pour les applications Microsoft DirectX, vous devez initialiser le thread initial à l’aide de Windows ::Foundation ::Initialize(RO_INIT_MULTITHREADED).

Pour un serveur EXE hors processus, vous devez initialiser le thread initial du serveur à l’aide de Windows ::Foundation ::Initialize(RO_INIT_MULTITHREADED).

Configuration requise

Voir aussi

RO_INIT_TYPE