Fungsi NPGetConnection (npapi.h)

Mengambil informasi tentang koneksi.

Syntax

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

Parameter-parameternya

[in] lpLocalName

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

[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.

Mengembalikan nilai

Jika fungsi berhasil, fungsi harus mengembalikan WN_SUCCESS. Jika tidak, kode kesalahan harus dikembalikan, yang bisa menjadi salah satu hal 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

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