Freigeben über


RoInitialize-Funktion (roapi.h)

Initialisiert die Windows-Runtime im aktuellen Thread mit dem angegebenen Parallelitätsmodell.

Syntax

HRESULT RoInitialize(
  [in] RO_INIT_TYPE initType
);

Die 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ücklaufwerte E_INVALIDARG, E_OUTOFMEMORY und E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode Description
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 eine Änderung von Neutralthread-Wohnung zu Singlethread-Wohnung eingetreten ist.

Bemerkungen

Verwenden Sie die RoInitialize-Funktion , um einen Thread in der Windows-Runtime zu initialisieren. Alle Threads, die Windows-Runtime-Objekte aktivieren und interagieren, müssen vor dem Aufrufen der Windows-Runtime initialisiert werden.

Rufen Sie die RoUninitialize-Funktion auf, um die Windows-Runtime im aktuellen Thread zu schließen. Jeder erfolgreiche Aufruf von RoInitialize, einschließlich derjenigen, die S_FALSE zurückgeben, muss durch einen entsprechenden Aufruf von RoUninitialize ausgeglichen werden.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 8 [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Fenster
Header roapi.h
Library mincore.lib

Siehe auch

CoInitializeEx-

RO_INIT_TYPE

RoUninitialize