Fungsi LookupPrivilegeValueA (winbase.h)

Artikel
03/13/2024

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