Fungsi NPGetConnection3 (npapi.h)

Mengambil informasi tentang koneksi jaringan, meskipun saat ini terputus.

Syntax

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

Parameter-parameternya

[in] lpLocalName

Penunjuk ke nama perangkat lokal yang diminati pemanggil. Penyedia dapat mengasumsikan bahwa ini valid secara sintetis.

[in] dwLevel

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

Nilai	Meaning
WNGETCON_CONNECTED	Sambungan 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.

Mengembalikan kode	Description
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.

Komentar

Koneksi jaringan dapat ada dalam 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]
Platform Target	Windows
Header	npapi.h