Fungsi LookupAccountSidLocalW (winbase.h)

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

Sintaksis

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

Parameter

[in] Sid

Penunjuk ke SID untuk dicari.

[out, optional] Name

Penunjuk ke buffer yang menerima string nullnull yang berisi nama akun yang sesuai dengan parameter lpSid.

[in, out] cchName

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

[out, optional] ReferencedDomainName

Penunjuk ke buffer yang menerima string nulldihentikan 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, dalamTCHAR , dari lpReferencedDomainName buffer. Jika fungsi gagal karena buffer terlalu kecil atau jika cchReferencedDomainName adalah nol, cchReferencedDomainName menerima ukuran buffer yang diperlukan, termasuk karakter null.

[out] peUse

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

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

Nota

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

Lihat juga

Gambaran Umum Kontrol Akses

Fungsi Kontrol Akses Dasar

EqualPrefixSid

LookupAccountName

SID

SID_NAME_USE