Fungsi GetUmsCompletionListEvent (winbase.h)

Artikel
03/03/2024

Mengambil handel ke peristiwa yang terkait dengan daftar penyelesaian penjadwalan mode pengguna (UMS) yang ditentukan.

Peringatan

Pada Windows 11, penjadwalan mode pengguna tidak didukung. Semua panggilan gagal dengan kesalahan ERROR_NOT_SUPPORTED.

Sintaks

BOOL GetUmsCompletionListEvent(
  [in]      PUMS_COMPLETION_LIST UmsCompletionList,
  [in, out] PHANDLE              UmsCompletionEvent
);

Parameter

[in] UmsCompletionList

Penunjuk ke daftar penyelesaian UMS. Fungsi CreateUmsCompletionList menyediakan penunjuk ini.

[in, out] UmsCompletionEvent

Penunjuk ke variabel HANDLE. Pada output, parameter UmsCompletionEvent diatur ke handel ke peristiwa yang terkait dengan daftar penyelesaian yang ditentukan.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan nilai bukan nol.

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

Keterangan

Sistem menandakan peristiwa daftar penyelesaian UMS saat sistem mengantre item ke daftar penyelesaian kosong. Handel peristiwa daftar penyelesaian dapat digunakan dengan fungsi tunggu apa pun yang menangani peristiwa. Ketika peristiwa disinyalkan, aplikasi biasanya memanggil DequeueUmsCompletionListItems untuk mengambil konten daftar penyelesaian.

Penanganan aktivitas tetap valid hingga daftar penyelesaiannya dihapus. Jangan gunakan penanganan aktivitas untuk menunggu daftar penyelesaian yang telah dihapus atau sedang dalam proses dihapus.

Ketika handel tidak lagi diperlukan, gunakan fungsi CloseHandle untuk menutup handel.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 (hanya 64-bit) [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll
Set API	api-ms-win-core-ums-l1-1-0 (diperkenalkan di Windows 7)

Lihat juga

CreateUmsCompletionList

DequeueUmsCompletionListItems

Fungsi Tunggu

Bagikan melalui