Fungsi NPGetUser (npapi.h)

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

Syntax

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

Parameter-parameternya

[in] lpName

Penunjuk 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 membuat ulang 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.

Mengembalikan nilai

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

Mengembalikan kode	Description
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]
Platform Target	Windows
Header	npapi.h
Library	davclnt.lib