Fungsi LookupAccountNameA (winbase.h)

Artikel
03/08/2023

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