Fungsi SetTokenInformation (securitybaseapi.h)

Artikel
03/15/2023

Fungsi SetTokenInformation menetapkan berbagai jenis informasi untuk token akses tertentu. Informasi yang ditetapkan fungsi ini menggantikan informasi yang ada. Proses panggilan harus memiliki hak akses yang sesuai untuk mengatur informasi.

Sintaks

BOOL SetTokenInformation(
  [in] HANDLE                  TokenHandle,
  [in] TOKEN_INFORMATION_CLASS TokenInformationClass,
  [in] LPVOID                  TokenInformation,
  [in] DWORD                   TokenInformationLength
);

Parameter

[in] TokenHandle

Handel ke token akses yang informasinya akan diatur.

[in] TokenInformationClass

Nilai dari jenis TOKEN_INFORMATION_CLASS yang dijumlahkan yang mengidentifikasi jenis informasi yang ditetapkan fungsi. Nilai yang valid dari TOKEN_INFORMATION_CLASS dijelaskan dalam parameter TokenInformation .

[in] TokenInformation

Penunjuk ke buffer yang berisi informasi yang diatur dalam token akses. Struktur buffer ini tergantung pada jenis informasi yang ditentukan oleh parameter TokenInformationClass .

[in] TokenInformationLength

Menentukan panjang, dalam byte, dari buffer yang diacu oleh TokenInformation.

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan bukan nol.

Jika fungsi gagal, fungsi akan mengembalikan nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Untuk mengatur informasi hak istimewa, aplikasi dapat memanggil fungsi AdjustTokenPrivileges . Untuk mengatur grup token, aplikasi dapat memanggil fungsi AdjustTokenGroups .

Informasi jenis token hanya dapat diatur saat token akses dibuat.

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