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
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | roapi.h |