Fungsi GetUserNameA (winbase.h)

Mengambil nama pengguna yang terkait dengan utas saat ini.

Gunakan fungsi GetUserNameEx untuk mengambil nama pengguna dalam format tertentu. Informasi tambahan disediakan oleh antarmuka IADsADSystemInfo .

Sintaksis

BOOL GetUserNameA(
  [out]     LPSTR   lpBuffer,
  [in, out] LPDWORD pcbBuffer
);

Parameter

[out] lpBuffer

Penunjuk ke buffer untuk menerima nama masuk pengguna. Jika buffer ini tidak cukup besar untuk berisi seluruh nama pengguna, fungsi gagal. Ukuran buffer karakter (UNLEN + 1) akan menyimpan nama pengguna panjang maksimum termasuk karakter null yang mengakhiri. UNLEN didefinisikan dalam Lmcons.h.

[in, out] pcbBuffer

Pada input, variabel ini menentukan ukuran buffer lpBuffer, dalam TCHAR. Pada output, variabel menerima jumlah TCHAR disalin ke buffer, termasuk karakter null yang mengakhiri.

Jika lpBuffer terlalu kecil, fungsi gagal dan GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER. Parameter ini menerima ukuran buffer yang diperlukan, termasuk karakter null yang mengakhiri.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian adalah nilai bukan nol, dan variabel yang ditunjukkan oleh lpnSize berisi jumlah TCHAR disalin ke buffer yang ditentukan oleh lpBuffer, termasuk karakter null yang mengakhiri.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Jika utas saat ini meniru klien lain, fungsi GetUserName mengembalikan nama pengguna klien yang ditiru utas.

Jika GetUserName dipanggil dari proses yang berjalan di bawah akun "LAYANAN JARINGAN", string yang dikembalikan dalam lpBuffer mungkin berbeda tergantung pada versi Windows. Pada Windows XP, string "LAYANAN JARINGAN" dikembalikan. Pada Windows Vista, string "<HOSTNAME>$" dikembalikan.

Contoh

Misalnya, lihat Mendapatkan Informasi Sistem.

Persyaratan

Lihat juga

GetUserNameEx

LookupAccountName

Fungsi Informasi Sistem