Fungsi QueryUmsThreadInformation (winbase.h)

Artikel
03/03/2024

Mengambil informasi tentang 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 QueryUmsThreadInformation(
  [in]            PUMS_CONTEXT          UmsThread,
  [in]            UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
  [out]           PVOID                 UmsThreadInformation,
  [in]            ULONG                 UmsThreadInformationLength,
  [out, optional] PULONG                ReturnLength
);

Parameter

[in] UmsThread

Penunjuk ke konteks utas UMS.

[in] UmsThreadInfoClass

Nilai UMS_THREAD_INFO_CLASS yang menentukan jenis informasi yang akan diambil.

[out] UmsThreadInformation

Penunjuk ke buffer untuk menerima informasi yang ditentukan. Ukuran buffer yang diperlukan tergantung pada kelas informasi yang ditentukan.

Jika kelas informasi adalah UmsThreadContext atau UmsThreadTeb, buffer harus sizeof(PVOID).

Jika kelas informasi adalah UmsThreadIsSuspended atau UmsThreadIsTerminated, buffer harus sizeof(BOOLEAN).

[in] UmsThreadInformationLength

Ukuran buffer UmsThreadInformation , dalam byte.

[out, optional] ReturnLength

Penunjuk ke variabel ULONG. Pada output, parameter ini menerima jumlah byte yang ditulis ke buffer UmsThreadInformation .

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. Nilai kesalahan yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
ERROR_INFO_LENGTH_MISMATCH	Buffer terlalu kecil untuk informasi yang diminta.
ERROR_INVALID_INFO_CLASS	Kelas informasi yang ditentukan tidak didukung.
ERROR_NOT_SUPPORTED	UMS tidak didukung.

Keterangan

Fungsi QueryUmsThreadInformation mengambil informasi tentang utas pekerja UMS yang ditentukan seperti konteks yang ditentukan aplikasinya, blok eksekusi utasnya (TEB), dan apakah utas ditangguhkan atau dihentikan.

Struktur yang mendasar untuk utas pekerja UMS dikelola oleh sistem. Informasi yang tidak diekspos melalui QueryUmsThreadInformation harus dianggap dicadangkan.

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

SetUmsThreadInformation

UMS_THREAD_INFO_CLASS

Bagikan melalui