Fungsi DuplicateToken (securitybaseapi.h)

Artikel
03/04/2024

Fungsi DuplicateToken membuat token akses baru yang menduplikasi token yang sudah ada.

Sintaks

BOOL DuplicateToken(
  [in]  HANDLE                       ExistingTokenHandle,
  [in]  SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  [out] PHANDLE                      DuplicateTokenHandle
);

Parameter

[in] ExistingTokenHandle

Handel ke token akses yang dibuka dengan akses TOKEN_DUPLICATE.

[in] ImpersonationLevel

Menentukan jenis enumerasi SECURITY_IMPERSONATION_LEVEL yang memasok tingkat peniruan token baru.

[out] DuplicateTokenHandle

Penunjuk ke variabel yang menerima handel ke token duplikat. Handel ini memiliki akses TOKEN_IMPERSONATE dan TOKEN_QUERY ke token baru.

Setelah Anda selesai menggunakan token baru, panggil fungsi CloseHandle untuk menutup handel token.

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 DuplicateToken membuat token peniruan, yang dapat Anda gunakan dalam fungsi seperti SetThreadToken dan ImpersonateLoggedOnUser. Token yang dibuat oleh DuplicateToken tidak dapat digunakan dalam fungsi CreateProcessAsUser , yang memerlukan token utama. Untuk membuat token yang dapat Anda teruskan ke CreateProcessAsUser, gunakan fungsi DuplicateTokenEx .

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	securitybaseapi.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll