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.
Menampilkan kode | Deskripsi |
---|---|
|
Nilai dalam parameter lpName bukan nama perangkat yang dialihkan atau nama jarak jauh yang tersambung. |
|
Buffer, lpUserName, terlalu kecil. |
|
Jaringan tidak ada. |
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | npapi.h |