Fungsi NPGetUser (npapi.h)

  • Artikel

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
WN_NOT_CONNECTED
 Nilai dalam parameter lpName bukan nama perangkat yang dialihkan atau nama jarak jauh yang tersambung.
WN_MORE_DATA
 Buffer, lpUserName, terlalu kecil.
WN_NO_NETWORK
 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