Fungsi NPGetConnection (npapi.h)

Artikel
02/29/2024

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

Bagikan melalui