Funzione RoInitialize (roapi.h)

  • Articolo

Inizializza il 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 Descrizione
S_OK
 Il Windows Runtime è stato inizializzato correttamente in questo thread.
S_FALSE
 Il 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 appartamento multithread (MTA). Ciò potrebbe anche indicare che si è verificato un cambiamento da appartamento con thread neutrale a appartamento a thread singolo.

Commenti

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

Chiamare la funzione RoUninitialize per chiudere il 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 Valore
Client minimo supportato Windows 8 [app desktop | App UWP]
Server minimo supportato Windows Server 2012 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione roapi.h

Vedi anche

CoInitializeEx

RO_INIT_TYPE

RoUninitialize