Fungsi GetUserNameExA (secext.h)
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.
Sintaks
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 . Nama tidak boleh 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 mengakhiri.
[in, out] nSize
Pada input, variabel ini menentukan ukuran buffer lpNameBuffer , dalam TCHAR. Jika fungsi berhasil, variabel menerima jumlah TCHAR yang 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 yang mengakhiri.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. Nilai yang mungkin termasuk yang berikut ini.
| Menampilkan kode | Deskripsi |
|---|---|
|
Buffer lpNameBuffer terlalu kecil. Parameter lpnSize berisi jumlah byte yang diperlukan untuk menerima nama. |
|
Pengendali domain tidak tersedia untuk melakukan pencarian |
|
Nama pengguna tidak tersedia dalam format yang ditentukan. |
Keterangan
Catatan
Header secext.h mendefinisikan GetUserNameEx 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
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | secext.h (termasuk Security.h) |
| Pustaka | Secur32.lib |
| DLL | Secur32.dll |