Fungsi NPGetConnection (npapi.h)

  • Artikel

Mengambil informasi tentang koneksi.

Sintaks

DWORD NPGetConnection(
  [in]      LPWSTR  lpLocalName,
  [out]     LPWSTR  lpRemoteName,
  [in, out] LPDWORD lpnBufferLen
);

Parameter

[in] lpLocalName

Arahkan ke nama perangkat lokal yang diminati pemanggil. Penyedia jaringan dapat mengasumsikan nama ini valid secara sintaksis.

[out] lpRemoteName

Penunjuk ke buffer yang akan menerima nama jarak jauh yang digunakan untuk membuat koneksi. Buffer ini dialokasikan oleh pemanggil.

[in, out] lpnBufferLen

Penunjuk ke ukuran, dalam karakter, dari buffer lpRemoteName . Jika panggilan gagal karena buffer tidak cukup besar, lpBufferSize diatur ke ukuran buffer yang diperlukan.

Nilai kembali

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

Menampilkan kode Deskripsi
WN_NOT_CONNECTED
 Perangkat yang ditentukan oleh lpLocalName tidak dialihkan oleh penyedia ini.
WN_MORE_DATA
 Buffer terlalu kecil untuk menerima semua data.
WN_NO_NETWORK
 Jaringan tidak ada.

Keterangan

Fungsi NPGetConnection hanya dapat mengembalikan informasi tentang koneksi jaringan yang saat ini tersambung. Untuk mengambil informasi tentang koneksi jaringan yang saat ini terputus, gunakan NPGetConnection3.

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