Fungsi NPGetUser (npapi.h)

Mengambil nilai nama pengguna default saat ini atau nama pengguna yang digunakan untuk membuat koneksi jaringan.

Sintaks

DWORD NPGetUser(
  [in]      LPWSTR  lpName,
  [out]     LPWSTR  lpUserName,
  [in, out] LPDWORD lpnBufferLen
);

Parameter

[in] lpName

Arahkan ke nama perangkat lokal yang diminati pemanggil, atau nama jarak jauh untuk sumber daya yang telah disambungkan pengguna. Parameter ini mungkin NULL atau string kosong jika pemanggil tertarik pada nama pengguna yang saat ini masuk ke sistem. Jika nama jarak jauh untuk sumber daya diteruskan, dan pengguna terhubung ke sumber daya tersebut menggunakan nama yang berbeda, ada kemungkinan bahwa penyedia tidak dapat menyelesaikan nama pengguna mana yang akan dikembalikan. Dalam hal ini penyedia dapat membuat pilihan arbitrer di antara kemungkinan nama pengguna.

[out] lpUserName

Arahkan ke buffer untuk menerima nama pengguna. Ini harus menjadi nama yang dapat diteruskan ke fungsi NPAddConnection atau NPAddConnection3 untuk membangun kembali koneksi dengan nama pengguna yang sama.

[in, out] lpnBufferLen

Penunjuk ke ukuran, dalam karakter, dari buffer lpUserName . Jika panggilan gagal karena buffer tidak cukup besar, lokasi ini akan digunakan untuk mengembalikan ukuran buffer yang diperlukan.

Nilai kembali

Jika fungsi berhasil, fungsi harus mengembalikan WN_SUCCESS. Jika tidak, kode kesalahan harus dikembalikan, yang bisa menjadi salah satu dari yang berikut ini.

Persyaratan