Fungsi DeleteUmsThreadContext (winbase.h)

  • Artikel

Menghapus konteks utas penjadwalan mode pengguna (UMS) yang ditentukan. Utas harus dihentikan.

Peringatan

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

Sintaks

BOOL DeleteUmsThreadContext(
  [in] PUMS_CONTEXT UmsThread
);

Parameter

[in] UmsThread

Penunjuk ke konteks utas UMS yang akan dihapus. Fungsi CreateUmsThreadContext menyediakan penunjuk ini.

Menampilkan nilai

Jika fungsi berhasil, fungsi mengembalikan nilai bukan nol.

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

Keterangan

Konteks utas UMS tidak dapat dihapus hingga utas terkait dihentikan.

Ketika utas pekerja UMS selesai berjalan (misalnya, dengan mengembalikan dari fungsi titik entri utasnya), sistem mengakhiri utas, menetapkan status penghentian dalam konteks utas UMS utas, dan mengantre konteks utas UMS ke daftar penyelesaian terkait.

Setiap upaya untuk menjalankan utas UMS akan gagal karena utas sudah dihentikan.

Untuk memeriksa status penghentian utas, penjadwal aplikasi harus memanggil QueryUmsThreadInformation dengan kelas informasi UmsIsThreadTerminated .

Persyaratan

   
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

CreateUmsThreadContext

QueryUmsThreadInformation