Fungsi IsTokenRestricted (securitybaseapi.h)
Fungsi IsTokenRestricted menunjukkan apakah token berisi daftar pengidentifikasi keamanan terbatas (SID).
Sintaks
BOOL IsTokenRestricted(
[in] HANDLE TokenHandle
);
Parameter
[in] TokenHandle
Handel ke token akses untuk diuji.
Nilai kembali
Jika token berisi daftar pembatasan SID, nilai yang dikembalikan bukan nol.
Jika token tidak berisi daftar pembatasan SID, nilai yang dikembalikan adalah nol.
Jika terjadi kesalahan, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Fungsi CreateRestrictedToken dapat membatasi token dengan menonaktifkan SID, menghapus hak istimewa, dan menentukan daftar pembatasan SID. Fungsi IsTokenRestricted hanya memeriksa daftar SID pembatasan. Jika token tidak memiliki SID yang membatasi, IsTokenRestricted mengembalikan FALSE, meskipun token dibuat oleh panggilan ke CreateRestrictedToken.
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 |