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

Weitere Informationen

RO_INIT_TYPE