Bagikan melalui


Fungsi OpenThreadToken (processthreadsapi.h)

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

Lihat juga

Ringkasan Access Control

AccessCheck

AdjustTokenGroups

AdjustTokenPrivileges

Fungsi Access Control Dasar

CloseHandle

GetCurrentThreadToken

GetTokenInformation

OpenProcessToken

SECURITY_IMPERSONATION_LEVEL

SetThreadToken

SetTokenInformation