Fungsi InitOnceComplete (synchapi.h)

Menyelesaikan inisialisasi satu kali yang dimulai dengan fungsi InitOnceBeginInitialize .

Sintaks

BOOL InitOnceComplete(
  [in, out]      LPINIT_ONCE lpInitOnce,
  [in]           DWORD       dwFlags,
  [in, optional] LPVOID      lpContext
);

Parameter

[in, out] lpInitOnce

Penunjuk ke struktur inisialisasi satu kali.

[in] dwFlags

Parameter ini bisa menjadi salah satu bendera berikut.

Nilai	Makna
INIT_ONCE_ASYNC 0x00000002UL	Beroperasi dalam mode asinkron. Ini memungkinkan beberapa upaya penyelesaian untuk dijalankan secara paralel. Bendera ini harus cocok dengan bendera yang diteruskan dalam panggilan yang sesuai ke fungsi InitOnceBeginitialize . Bendera ini mungkin tidak digabungkan dengan INIT_ONCE_INIT_FAILED.
INIT_ONCE_INIT_FAILED 0x00000004UL	Upaya inisialisasi gagal. Bendera ini mungkin tidak digabungkan dengan INIT_ONCE_ASYNC. Untuk menggagalkan inisialisasi asinkron, tinggalkan saja (yaitu, jangan panggil fungsi InitOnceComplete ).

[in, optional] lpContext

Penunjuk ke data yang akan disimpan dengan struktur inisialisasi satu kali. Data ini dikembalikan dalam parameter lpContext yang diteruskan ke panggilan berikutnya ke fungsi InitOnceBeginitialize . Jika lpContext menunjuk ke nilai, INIT_ONCE_CTX_RESERVED_BITS berurutan rendah dari nilai harus nol. Jika lpContext menunjuk ke struktur data, struktur data harus selaras dengan DWORD.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Contoh

Untuk contoh yang menggunakan fungsi ini, lihat Menggunakan Inisialisasi One-Time.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	synchapi.h (sertakan Windows.h pada Windows 7, Windows Server 2008 Windows Server 2008 R2)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

InitOnceBeginInitialize

Inisialisasi Satu Kali

Fungsi Sinkronisasi