RoInitialize-Funktion (roapi.h)

  • Artikel

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
S_OK
 Die Windows-Runtime wurde in diesem Thread erfolgreich initialisiert.
S_FALSE
 Die Windows-Runtime wird bereits in diesem Thread initialisiert.
RPC_E_CHANGED_MODE
 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

Weitere Informationen

CoInitializeEx

RO_INIT_TYPE

RoUninitialize