Fungsi OpenThread (processthreadsapi.h)

Artikel
2023-08-25

Membuka objek utas yang ada.

Sintaks

HANDLE OpenThread(
  [in] DWORD dwDesiredAccess,
  [in] BOOL  bInheritHandle,
  [in] DWORD dwThreadId
);

Parameter

[in] dwDesiredAccess

Akses ke objek utas. Hak akses ini diperiksa terhadap deskriptor keamanan untuk utas. Parameter ini bisa menjadi satu atau beberapa hak akses utas.

Jika pemanggil telah mengaktifkan hak istimewa SeDebugPrivilege, akses yang diminta diberikan terlepas dari konten pendeskripsi keamanan.

[in] bInheritHandle

Jika nilai ini TRUE, proses yang dibuat oleh proses ini akan mewarisi handel. Jika tidak, proses tidak mewarisi handel ini.

[in] dwThreadId

Pengidentifikasi utas yang akan dibuka.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel terbuka ke utas yang ditentukan.

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

Keterangan

Handel yang dikembalikan oleh OpenThread dapat digunakan dalam fungsi apa pun yang memerlukan handel ke utas, seperti fungsi tunggu, asalkan Anda meminta hak akses yang sesuai. Handel diberikan akses ke objek utas hanya sejauh ditentukan dalam parameter dwDesiredAccess .

Setelah selesai dengan handel, pastikan untuk menutupnya dengan menggunakan fungsi CloseHandle .

Persyaratan

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