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.

Sintaksis

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

Penunjuk ke variabel yang menerima LUID tempat hak istimewa diketahui pada sistem yang ditentukan oleh parameter lpSystemName.

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan nonzero.

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

Komentar

Fungsi LookupPrivilegeValue hanya mendukung hak istimewa yang ditentukan di bagian Hak Istimewa yang Ditentukan di Winnt.h. Untuk daftar nilai, lihatKonstanta Hak Istimewa .

Contoh

Untuk contoh yang menggunakan fungsi ini, lihat Mengaktifkan dan Menonaktifkan Hak Istimewa.

Nota

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

Syarat	Nilai
klien minimum yang didukung	Windows XP [aplikasi desktop | Aplikasi UWP]
server minimum yang didukung	Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Platform Target	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

Kontrol Akses

Fungsi Kontrol Akses Dasar

lookupPrivilegeDisplayName

LookupPrivilegeName