Fungsi SetUmsThreadInformation (winbase.h)
Mengatur informasi konteks khusus aplikasi untuk utas pekerja 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 SetUmsThreadInformation(
[in] PUMS_CONTEXT UmsThread,
[in] UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
[in] PVOID UmsThreadInformation,
[in] ULONG UmsThreadInformationLength
);
Parameter
[in] UmsThread
Penunjuk ke konteks utas UMS.
[in] UmsThreadInfoClass
Nilai UMS_THREAD_INFO_CLASS yang menentukan jenis informasi yang akan ditetapkan. Parameter ini harus UmsThreadUserContext.
[in] UmsThreadInformation
Penunjuk ke buffer yang berisi informasi yang akan diatur.
[in] UmsThreadInformationLength
Ukuran buffer UmsThreadInformation , dalam byte.
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. Kemungkinan nilai kesalahan termasuk yang berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Ukuran buffer tidak cocok dengan ukuran yang diperlukan untuk kelas informasi yang ditentukan. |
|
Parameter UmsThreadInfoClass menentukan kelas informasi yang tidak didukung. |
|
UMS tidak didukung. |
Keterangan
Fungsi SetUmsThreadInformation dapat digunakan untuk mengatur konteks yang ditentukan aplikasi untuk utas pekerja UMS yang ditentukan. Informasi konteks dapat terdiri dari apa pun yang mungkin berguna bagi aplikasi untuk dilacak, seperti status alur per penjadwal atau per pekerja. Struktur yang mendasar untuk utas pekerja UMS dikelola oleh sistem dan tidak boleh dimodifikasi secara langsung.
Fungsi QueryUmsThreadInformation dapat digunakan untuk mengambil informasi lain yang diekspos tentang utas yang ditentukan, seperti blok eksekusi utas (TEB) dan apakah utas ditangguhkan atau dihentikan. Informasi yang tidak diekspos melalui QueryUmsThreadInformation harus dianggap dicadangkan.
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk