Fungsi RoInitialize (roapi.h)

Menginisialisasi Windows Runtime pada utas saat ini dengan model konkurensi yang ditentukan.

Syntax

HRESULT RoInitialize(
  [in] RO_INIT_TYPE initType
);

Parameter-parameternya

[in] initType

Jenis: RO_INIT_TYPE

Model konkurensi untuk utas. Defaultnya adalah RO_INIT_MULTITHREADED.

Mengembalikan nilai

Jenis: HRESULT

Fungsi ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, dan E_UNEXPECTED, serta nilai berikut.

Mengembalikan kode	Description
S_OK	Windows Runtime berhasil diinisialisasi pada utas ini.
S_FALSE	Windows Runtime sudah diinisialisasi pada utas ini.
RPC_E_CHANGED_MODE	Panggilan sebelumnya ke RoInitialize menentukan model konkurensi untuk utas ini sebagai apartemen multithread (MTA). Ini juga dapat menunjukkan bahwa perubahan dari apartemen berulir netral ke apartemen berulir tunggal telah terjadi.

Komentar

Gunakan fungsi RoInitialize untuk menginisialisasi utas di Windows Runtime. Semua utas yang mengaktifkan dan berinteraksi dengan objek Windows Runtime harus diinisialisasi sebelum memanggil ke Windows Runtime.

Panggil fungsi RoUninitialize untuk menutup Windows Runtime pada utas saat ini. Setiap panggilan yang berhasil ke RoInitialize, termasuk yang mengembalikan S_FALSE, harus diseimbangkan dengan panggilan yang sesuai ke RoUninitialize.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Platform Target	Windows
Header	roapi.h
Library	mincore.lib

Lihat juga

CoInitializeEx

RO_INIT_TYPE

RoUninitialize