Fungsi LookupAccountNameA (winbase.h)
Fungsi LookupAccountName menerima nama sistem dan akun sebagai input. Ini mengambil pengidentifikasi keamanan (SID) untuk akun dan nama domain tempat akun ditemukan.
Fungsi LsaLookupNames juga dapat mengambil akun komputer.
Sintaks
BOOL LookupAccountNameA(
[in, optional] LPCSTR lpSystemName,
[in] LPCSTR lpAccountName,
[out, optional] PSID Sid,
[in, out] LPDWORD cbSid,
[out, optional] LPSTR ReferencedDomainName,
[in, out] LPDWORD cchReferencedDomainName,
[out] PSID_NAME_USE peUse
);
Parameter
[in, optional] lpSystemName
Penunjuk ke string karakter yang dihentikan null yang menentukan nama sistem. String ini bisa menjadi nama komputer jarak jauh. Jika string ini NULL, terjemahan nama akun dimulai pada sistem lokal. Jika nama tidak dapat diselesaikan pada sistem lokal, fungsi ini akan mencoba mengatasi nama menggunakan pengendali domain yang dipercaya oleh sistem lokal. Umumnya, tentukan nilai untuk lpSystemName hanya ketika akun berada di domain yang tidak tepercaya dan nama komputer di domain tersebut diketahui.
[in] lpAccountName
Penunjuk ke string yang dihentikan null yang menentukan nama akun.
Gunakan string yang sepenuhnya memenuhi syarat dalam format domain_name\user_name untuk memastikan bahwa LookupAccountName menemukan akun di domain yang diinginkan.
[out, optional] Sid
Penunjuk ke buffer yang menerima struktur SID yang sesuai dengan nama akun yang ditujukkan oleh parameter lpAccountName . Jika parameter ini NULL, cbSid harus nol.
[in, out] cbSid
Penunjuk ke variabel. Pada input, nilai ini menentukan ukuran, dalam byte, dari buffer Sid . Jika fungsi gagal karena buffer terlalu kecil atau jika cbSid nol, variabel ini menerima ukuran buffer yang diperlukan.
[out, optional] ReferencedDomainName
Penunjuk ke buffer yang menerima nama domain tempat nama akun ditemukan. Untuk komputer yang tidak tergabung ke domain, buffer ini menerima nama komputer. Jika parameter ini NULL, fungsi mengembalikan ukuran buffer yang diperlukan.
[in, out] cchReferencedDomainName
Penunjuk ke variabel. Pada input, nilai ini menentukan ukuran, dalam TCHARs, dari buffer ReferencedDomainName . Jika fungsi gagal karena buffer terlalu kecil, variabel ini menerima ukuran buffer yang diperlukan, termasuk karakter null yang mengakhiri. Jika parameter ReferencedDomainName adalah NULL, parameter ini harus nol.
[out] peUse
Penunjuk ke jenis SID_NAME_USE yang dijumlahkan yang menunjukkan jenis akun saat fungsi kembali.
Nilai kembali
Jika fungsi berhasil, fungsi mengembalikan bukan nol.
Jika fungsi gagal, fungsi akan mengembalikan nol. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Fungsi LookupAccountName mencoba menemukan SID untuk nama yang ditentukan dengan terlebih dahulu memeriksa daftar SID terkenal. Jika nama tidak sesuai dengan SID terkenal, fungsi memeriksa akun lokal bawaan dan yang ditentukan secara administratif. Selanjutnya, fungsi memeriksa domain utama. Jika nama tidak ditemukan di sana, domain tepercaya akan diperiksa.
Gunakan nama akun yang sepenuhnya memenuhi syarat (misalnya, domain_name\user_name) alih-alih nama yang terisolasi (misalnya, user_name). Nama yang sepenuhnya memenuhi syarat tidak ambigu dan memberikan performa yang lebih baik saat pencarian dilakukan. Fungsi ini juga mendukung nama DNS yang sepenuhnya memenuhi syarat (misalnya, example.example.com\user_name) dan nama prinsipal pengguna (UPN) (misalnya, someone@example.com).
Selain mencari akun lokal, akun domain lokal, dan akun domain tepercaya secara eksplisit, LookupAccountName dapat mencari nama untuk akun apa pun di domain apa pun di forest.
Catatan
Header winbase.h mendefinisikan LookupAccountName sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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