Fungsi GetUserNameExA (secext.h)

  • Artikel

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
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.

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

Lihat juga

EXTENDED_NAME_FORMAT

LookupAccountName

Fungsi Informasi Sistem