RoInitialize-Funktion (roapi.h)
Initialisiert die Windows-Runtime im aktuellen Thread mit dem angegebenen Parallelitätsmodell.
Syntax
HRESULT RoInitialize(
[in] RO_INIT_TYPE initType
);
Parameter
[in] initType
Typ: RO_INIT_TYPE
Das Parallelitätsmodell für den Thread. Der Standardwert ist RO_INIT_MULTITHREADED.
Rückgabewert
Typ: HRESULT
Diese Funktion kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY und E_UNEXPECTED sowie die folgenden Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Windows-Runtime wurde in diesem Thread erfolgreich initialisiert. |
|
Die Windows-Runtime wird bereits in diesem Thread initialisiert. |
|
Ein vorheriger Aufruf von RoInitialize hat das Parallelitätsmodell für diesen Thread als Multithread-Apartment (MTA) angegeben. Dies könnte auch darauf hindeuten, dass ein Wechsel von Neutralthread-Wohnung zu Singlethread-Wohnung stattgefunden hat. |
Hinweise
Verwenden Sie die RoInitialize-Funktion, um einen Thread im Windows-Runtime zu initialisieren. Alle Threads, die Windows-Runtime Objekte aktivieren und mit ihnen interagieren, müssen vor dem Aufrufen des Windows-Runtime initialisiert werden.
Rufen Sie die Funktion RoUninitialize auf, um die Windows-Runtime im aktuellen Thread zu schließen. Jeder erfolgreiche Aufruf von RoInitialize, einschließlich der Aufrufe, die S_FALSE zurückgeben, muss durch einen entsprechenden Aufruf von RoUninitialize ausgeglichen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | roapi.h |