Bagikan melalui


Fungsi SetThreadToken (processthreadsapi.h)

Fungsi SetThreadToken menetapkan token peniruan ke utas. Fungsi ini juga dapat menyebabkan utas berhenti menggunakan token peniruan identitas.

Sintaks

BOOL SetThreadToken(
  [in, optional] PHANDLE Thread,
  [in, optional] HANDLE  Token
);

Parameter

[in, optional] Thread

Penunjuk ke handel ke utas tempat fungsi menetapkan token peniruan.

Jika ThreadNULL, fungsi menetapkan token peniruan ke utas panggilan.

[in, optional] Token

Handel ke token peniruan untuk ditetapkan ke utas. Handel ini harus dibuka dengan hak akses TOKEN_IMPERSONATE. Untuk informasi selengkapnya, lihat Hak Akses untuk Objek Access-Token.

Jika TokenNULL, fungsi menyebabkan utas berhenti menggunakan token peniruan identitas.

Mengembalikan 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.

Keterangan

Saat menggunakan fungsi SetThreadToken untuk meniru, Anda harus memiliki hak istimewa peniruan dan memastikan bahwa fungsi SetThreadToken berhasil sebelum memanggil fungsi RevertToSelf .

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

Lihat juga

Ringkasan Access Control

Fungsi Access Control Dasar

OpenThreadToken