Fungsi OpenThreadToken (processthreadsapi.h)

Artikel
03/08/2023

Fungsi OpenThreadToken membuka token akses yang terkait dengan utas.

Sintaks

BOOL OpenThreadToken(
  [in]  HANDLE  ThreadHandle,
  [in]  DWORD   DesiredAccess,
  [in]  BOOL    OpenAsSelf,
  [out] PHANDLE TokenHandle
);

Parameter

[in] ThreadHandle

Handel ke utas yang token aksesnya dibuka.

[in] DesiredAccess

Menentukan masker akses yang menentukan jenis akses yang diminta ke token akses. Jenis akses yang diminta ini direkonsiliasi terhadap daftar kontrol akses diskresi (DACL) token untuk menentukan akses mana yang diberikan atau ditolak.

Untuk daftar hak akses untuk token akses, lihat Hak Akses untuk Objek Access-Token.

[in] OpenAsSelf

TRUE jika pemeriksaan akses akan dilakukan terhadap konteks keamanan tingkat proses.

FALSE jika pemeriksaan akses akan dilakukan terhadap konteks keamanan saat ini dari utas yang memanggil fungsi OpenThreadToken .

Parameter OpenAsSelf memungkinkan pemanggil fungsi ini untuk membuka token akses utas tertentu ketika pemanggil meniru token di tingkat SecurityIdentification . Tanpa parameter ini, utas panggilan tidak dapat membuka token akses pada utas yang ditentukan karena tidak mungkin untuk membuka objek tingkat eksekutif dengan menggunakan tingkat peniruan Identitas Keamanan .

[out] TokenHandle

Penunjuk ke variabel yang menerima handel ke token akses yang baru dibuka.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. Jika token memiliki tingkat peniruan nama anonim, token tidak akan dibuka dan OpenThreadToken menetapkan ERROR_CANT_OPEN_ANONYMOUS sebagai kesalahan.

Keterangan

Token dengan tingkat peniruan nama anonim tidak dapat dibuka.

Tutup handel token akses yang dikembalikan melalui parameter TokenHandle dengan memanggil CloseHandle.

Persyaratan


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)
Pustaka	Advapi32.lib
DLL	Advapi32.dll