Inizializzare la funzione (roapi.h)

Inizializza un thread da usare Windows Runtime API.

Sintassi

HRESULT Initialize(
  RO_INIT_TYPE initType
);

Parametri

initType

Specifica il tipo di appartamento del thread da inizializzare.

Valore restituito

• S_OK - Inizializzato correttamente per la prima volta nel thread corrente
• S_FALSE - Inizializzazione annidata riuscita (il thread corrente è già stato inizializzato per il tipo di appartamento specificato)
• E_INVALIDARG - Valore initType non valido
• CO_E_INIT_TLS - Impossibile allocare la struttura TLS interna di COM
• E_OUTOFMEMORY - Impossibile allocare strutture per thread/per-apartment diverse da TLS
• RPC_E_CHANGED_MODE : il thread corrente è già inizializzato per un tipo di appartamento diverso da quello specificato.

Commenti

Windows::Foundation::Initialize viene modificato in modo da creare ASTAs anziché gli STA classici per il valore RO_INIT_TYPE RO_INIT_SINGLETHREADED. Windows::Foundation::Initialize(RO_INIT_SINGLETHREADED) non è supportato per le applicazioni desktop e restituirà CO_E_NOTSUPPORTED se viene chiamato da un processo diverso da un'app di Windows Store.

Per le applicazioni Microsoft DirectX, è necessario inizializzare il thread iniziale usando Windows::Foundation::Initialize(RO_INIT_MULTITHREADED).

Per un server EXE out-of-process, è necessario inizializzare il thread iniziale del server usando Windows::Foundation::Initialize(RO_INIT_MULTITHREADED).

Requisiti

Vedi anche

RO_INIT_TYPE