Funzione RoInitialize (roapi.h)

Inizializza Windows Runtime nel thread corrente con il modello di concorrenza specificato.

Sintassi

HRESULT RoInitialize(
  [in] RO_INIT_TYPE initType
);

Parametri

[in] initType

Tipo: RO_INIT_TYPE

Modello di concorrenza per il thread. Il valore predefinito è RO_INIT_MULTITHREADED.

Valore restituito

Tipo: HRESULT

Questa funzione può restituire i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY e E_UNEXPECTED, nonché i valori seguenti.

Codice restituito	Description
S_OK	Windows Runtime è stato inizializzato correttamente in questo thread.
S_FALSE	Windows Runtime è già inizializzato in questo thread.
RPC_E_CHANGED_MODE	Una chiamata precedente a RoInitialize ha specificato il modello di concorrenza per questo thread come apartment multithread (MTA). Ciò potrebbe anche indicare che si è verificato un cambiamento da apartment a thread singolo a thread neutro.

Osservazioni:

Usare la funzione RoInitialize per inizializzare un thread in Windows Runtime. Tutti i thread che attivano e interagiscono con oggetti Windows Runtime devono essere inizializzati prima di chiamare in Windows Runtime.

Chiamare la funzione RoUninitialize per chiudere Windows Runtime nel thread corrente. Ogni chiamata riuscita a RoInitialize, incluse quelle che restituiscono S_FALSE, deve essere bilanciata da una chiamata corrispondente a RoUninitialize.

Requisiti

Requisito	Value
Client minimo supportato	Windows 8 [app desktop | App UWP]
Server minimo supportato	Windows Server 2012 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Header	roapi.h
Library	mincore.lib

Vedere anche

CoInitializeEx

RO_INIT_TYPE

RoUninitialize