Meniru fungsiSelf (securitybaseapi.h)

Artikel
03/01/2024

Fungsi ImpersonateSelf mendapatkan token akses yang meniru konteks keamanan proses panggilan. Token ditetapkan ke utas panggilan.

Sintaks

BOOL ImpersonateSelf(
  [in] SECURITY_IMPERSONATION_LEVEL ImpersonationLevel
);

Parameter

[in] ImpersonationLevel

Menentukan jenis enumerasi SECURITY_IMPERSONATION_LEVEL yang memasok tingkat peniruan token baru.

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

Fungsi ImpersonateSelf digunakan untuk tugas-tugas seperti mengaktifkan hak istimewa untuk satu utas daripada untuk seluruh proses atau untuk mengubah daftar kontrol akses diskresi default (DACL) untuk satu utas.

Server dapat memanggil fungsi RevertToSelf ketika peniruan selesai.

Agar fungsi ini berhasil, DACL yang melindungi token proses harus memberikan hak TOKEN_DUPLICATE itu sendiri.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	securitybaseapi.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll