Initialize-Funktion (roapi.h)
Initialisiert einen Thread, um Windows-Runtime-APIs zu verwenden.
Syntax
HRESULT Initialize(
RO_INIT_TYPE initType
);
Parameter
initType
Gibt den Apartmenttyp des zu initialisierenden Threads an.
Rückgabewert
- S_OK : Erstmalige Initialisierung im aktuellen Thread erfolgreich
- S_FALSE : Erfolgreiche geschachtelte Initialisierung (der aktuelle Thread wurde bereits für den angegebenen Apartmenttyp initialisiert)
- E_INVALIDARG : Ungültiger initType-Wert
- CO_E_INIT_TLS : Fehler beim Zuordnen der internen TLS-Struktur von COM
- E_OUTOFMEMORY : Fehler beim Zuordnen von Strukturen pro Thread/Apartment außer tls
- RPC_E_CHANGED_MODE : Der aktuelle Thread wird bereits für einen anderen Apartmenttyp als die angegebenen initialisiert.
Hinweise
Windows::Foundation::Initialize wird geändert, um ASTAs anstelle klassischer STAs für den RO_INIT_TYPE Wert RO_INIT_SINGLETHREADED zu erstellen. Windows::Foundation::Initialize(RO_INIT_SINGLETHREADED) wird für Desktopanwendungen nicht unterstützt und gibt CO_E_NOTSUPPORTED zurück, wenn es von einem anderen Prozess als einer Windows Store-App aufgerufen wird.
Für Microsoft DirectX-Anwendungen müssen Sie den anfänglichen Thread mit Windows::Foundation::Initialize(RO_INIT_MULTITHREADED) initialisieren.
Für einen out-of-process EXE-Server müssen Sie den anfänglichen Thread des Servers mithilfe von Windows::Foundation::Initialize(RO_INIT_MULTITHREADED) initialisieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | roapi.h |