Fungsi RoInitialize (roapi.h)

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

Sintaks

HRESULT RoInitialize(
  [in] RO_INIT_TYPE initType
);

Parameter

[in] initType

Jenis: RO_INIT_TYPE

Model konkurensi untuk utas. Defaultnya adalah RO_INIT_MULTITHREADED.

Nilai kembali

Jenis: HRESULT

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

Menampilkan kode	Deskripsi
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 bisa menunjukkan bahwa perubahan dari apartemen berulir netral ke apartemen berulir tunggal telah terjadi.

Keterangan

Gunakan fungsi RoInitialize untuk menginisialisasi utas di Windows Runtime. Semua utas yang mengaktifkan dan berinteraksi dengan objek Windows Runtime harus diinisialisasi sebelum memanggil 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]
Target Platform	Windows
Header	roapi.h

Lihat juga

CoInitializeEx

RO_INIT_TYPE

RoUninitialize