Fungsi NPGetConnection3 (npapi.h)

Artikel
02/29/2024

Mengambil informasi tentang koneksi jaringan, meskipun saat ini sambungan terputus.

Sintaks

DWORD NPGetConnection3(
  [in]      LPCWSTR lpLocalName,
  [in]      DWORD   dwLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

Parameter

[in] lpLocalName

Penunjuk ke nama perangkat lokal yang diminati pemanggil. Penyedia dapat berasumsi bahwa ini valid secara sintaksis.

[in] dwLevel

Nilai yang menentukan apakah koneksi jaringan saat ini tersambung atau terputus.

Nilai	Makna
WNGETCON_CONNECTED	Koneksi jaringan tersambung.
WNGETCON_DISCONNECTED	Sambungan jaringan terputus.

[out] lpBuffer

Void pointer yang menerima buffer yang berisi informasi yang diminta.

[in, out] lpBufferSize

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

Mengembalikan nilai

Jika fungsi berhasil, fungsi harus mengembalikan WN_SUCCESS.

Jika fungsi gagal, fungsi harus mengembalikan salah satu nilai 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

Koneksi jaringan dapat ada di tiga status: tersambung, terputus, dan tidak tersedia. Fungsi NPGetConnection3 tidak dapat mengambil informasi tentang koneksi jaringan yang saat ini tidak tersedia. Namun, ini dapat mengambil informasi tentang koneksi jaringan yang saat ini terputus karena Windows menyimpan informasi koneksi.

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