Fungsi LookupPrivilegeValueA (winbase.h)
Fungsi LookupPrivilegeValue mengambil pengidentifikasi unik lokal (LUID) yang digunakan pada sistem tertentu untuk mewakili nama hak istimewa yang ditentukan secara lokal.
Sintaks
BOOL LookupPrivilegeValueA(
[in, optional] LPCSTR lpSystemName,
[in] LPCSTR lpName,
[out] PLUID lpLuid
);
Parameter
[in, optional] lpSystemName
Penunjuk ke string yang dihentikan null yang menentukan nama sistem tempat nama hak istimewa diambil. Jika string null ditentukan, fungsi mencoba menemukan nama hak istimewa pada sistem lokal.
[in] lpName
Penunjuk ke string yang dihentikan null yang menentukan nama hak istimewa, seperti yang didefinisikan dalam file header Winnt.h. Misalnya, parameter ini dapat menentukan konstanta, SE_SECURITY_NAME, atau string yang sesuai, "SeSecurityPrivilege".
[out] lpLuid
Pointer ke variabel yang menerima LUID tempat hak istimewa diketahui pada sistem yang ditentukan oleh parameter lpSystemName .
Nilai kembali
Jika fungsi berhasil, fungsi mengembalikan bukan nol.
Jika fungsi gagal, fungsi akan mengembalikan nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Fungsi LookupPrivilegeValue hanya mendukung hak istimewa yang ditentukan di bagian Hak Istimewa yang Ditentukan di Winnt.h. Untuk daftar nilai, lihat Konstanta Hak Istimewa.
Contoh
Untuk contoh yang menggunakan fungsi ini, lihat Mengaktifkan dan Menonaktifkan Hak Istimewa.
Catatan
Header winbase.h mendefinisikan LookupPrivilegeValue sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
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 | winbase.h (termasuk Windows.h) |
Pustaka | Advapi32.lib |
DLL | Advapi32.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk