Fungsi GetUserNameExA (secext.h)

Artikel
11/20/2024

Mengambil nama pengguna atau prinsip keamanan lain yang terkait dengan utas panggilan. Anda dapat menentukan format nama yang dikembalikan.

Jika utas meniru klien, GetUserNameEx mengembalikan nama klien.

Sintaksis

BOOLEAN SEC_ENTRY GetUserNameExA(
  [in]      EXTENDED_NAME_FORMAT NameFormat,
  [out]     LPSTR                lpNameBuffer,
  [in, out] PULONG               nSize
);

Parameter

[in] NameFormat

Format nama. Parameter ini adalah nilai dari jenis enumerasi EXTENDED_NAME_FORMAT. Ini tidak dapat NameUnknown. Jika akun pengguna tidak berada di domain, hanya NameSamCompatible yang didukung.

[out] lpNameBuffer

Penunjuk ke buffer yang menerima nama dalam format yang ditentukan. Buffer harus menyertakan ruang untuk karakter null yang dihentikan.

[in, out] nSize

Pada input, variabel ini menentukan ukuran buffer lpNameBuffer , dalam TCHAR. Jika fungsi berhasil, variabel menerima jumlah TCHAR disalin ke buffer, tidak termasuk karakter null yang mengakhiri.

Jika lpNameBuffer terlalu kecil, fungsi gagal dan GetLastError mengembalikan ERROR_MORE_DATA. Parameter ini menerima ukuran buffer yang diperlukan, dalam karakter Unicode (apakah Unicode sedang digunakan atau tidak), termasuk karakter null penghentian.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError. Nilai yang mungkin termasuk yang berikut ini.

Mengembalikan kode	Deskripsi
ERROR_MORE_DATA	Buffer lpNameBuffer terlalu kecil. Parameter lpnSize berisi jumlah byte yang diperlukan untuk menerima nama.
ERROR_NO_SUCH_DOMAIN	Pengendali domain tidak tersedia untuk melakukan pencarian
ERROR_NONE_MAPPED	Nama pengguna tidak tersedia dalam format yang ditentukan.

Komentar

Nota

Header secext.h mendefinisikan GetUserNameEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	secext.h (termasuk Security.h)
Pustaka	Secur32.lib
DLL	Secur32.dll

Lihat juga

EXTENDED_NAME_FORMAT

LookupAccountName

Fungsi Informasi Sistem

Bagikan melalui