Fungsi LookupAccountSidLocalA (winbase.h)

Artikel
03/13/2024

LookupAccountSidLocalA didefinisikan sebagai makro yang memanggil LookupAccountSidA dengan NULL sebagai parameter pertama. Mengambil nama akun untuk SID yang ditentukan pada komputer lokal.

Sintaks

BOOL LookupAccountSidLocalA(
  [in]            PSID          Sid,
  [out, optional] LPSTR         Name,
  [in, out]       LPDWORD       cchName,
  [out, optional] LPSTR         ReferencedDomainName,
  [in, out]       LPDWORD       cchReferencedDomainName,
  [out]           PSID_NAME_USE peUse
);

Parameter

[in] Sid

Penunjuk ke SID untuk mencari.

[out, optional] Name

Pointer ke buffer yang menerima string null-terminated yang berisi nama akun yang sesuai dengan parameter lpSid .

[in, out] cchName

Pada input, menentukan ukuran, dalam TCHARs, dari buffer lpName . Jika fungsi gagal karena buffer terlalu kecil atau jika cchName nol, cchName menerima ukuran buffer yang diperlukan, termasuk karakter null yang mengakhiri.

[out, optional] ReferencedDomainName

Penunjuk ke buffer yang menerima string yang dihentikan null yang berisi nama domain tempat nama akun ditemukan.

Di server, nama domain yang dikembalikan untuk sebagian besar akun dalam database keamanan komputer lokal adalah nama domain yang servernya adalah pengendali domain.

Pada stasiun kerja, nama domain yang dikembalikan untuk sebagian besar akun dalam database keamanan komputer lokal adalah nama komputer pada awal terakhir sistem (garis miring terbalik dikecualikan). Jika nama komputer berubah, nama lama terus dikembalikan sebagai nama domain hingga sistem dimulai ulang.

Beberapa akun telah ditentukan sebelumnya oleh sistem. Nama domain yang dikembalikan untuk akun ini adalah BUILTIN.

[in, out] cchReferencedDomainName

Pada input, menentukan ukuran, dalam TCHARs, dari buffer lpReferencedDomainName . Jika fungsi gagal karena buffer terlalu kecil atau jika cchReferencedDomainName nol, cchReferencedDomainName menerima ukuran buffer yang diperlukan, termasuk karakter null yang mengakhiri.

[out] peUse

Penunjuk ke variabel yang menerima nilai SID_NAME_USE yang menunjukkan jenis akun.

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 ini mirip dengan LookupAccountSid, tetapi membatasi pencarian ke komputer lokal.

Catatan

Header winbase.h mendefinisikan LookupAccountSidLocal 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 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)