Fungsi MultinetGetConnectionPerformanceA (winnetwk.h)

Artikel
03/08/2023

Fungsi MultinetGetConnectionPerformance mengembalikan informasi tentang performa koneksi yang diharapkan yang digunakan untuk mengakses sumber daya jaringan.

Sintaks

DWORD MultinetGetConnectionPerformanceA(
  [in]  LPNETRESOURCEA         lpNetResource,
  [out] LPNETCONNECTINFOSTRUCT lpNetConnectInfoStruct
);

Parameter

[in] lpNetResource

Penunjuk ke struktur NETRESOURCE yang menentukan sumber daya jaringan. Anggota berikut memiliki arti khusus dalam konteks ini.

Anggota	Makna
lpLocalName	Penunjuk ke buffer yang menentukan perangkat lokal, seperti "F:" atau "LPT1", yang dialihkan ke sumber daya jaringan yang akan dikueri. Jika anggota ini NULL atau string kosong, sumber daya jaringan ditentukan dalam anggota lpRemoteName . Jika bendera ini menentukan perangkat lokal, lpRemoteName diabaikan.
lpRemoteName	Penunjuk ke sumber daya jaringan untuk dikueri. Sumber daya saat ini harus memiliki koneksi yang dibuat. Misalnya, jika sumber daya adalah file di server file, maka membuka file akan memastikan koneksi.
lpProvider	Biasanya diatur ke NULL, tetapi dapat menjadi penunjuk ke pemilik (penyedia) sumber daya jika jaringan tempat sumber daya berada diketahui. Jika anggota lpProvider bukan NULL, sistem mencoba mengembalikan informasi hanya tentang jaringan bernama.

[out] lpNetConnectInfoStruct

Penunjuk ke struktur NETCONNECTINFOSTRUCT yang menerima data.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem, seperti salah satu nilai berikut.

Menampilkan kode	Deskripsi
ERROR_NOT_SUPPORTED	Sumber daya jaringan tidak menyediakan informasi ini.
ERROR_NOT_CONNECTED	Anggota lpLocalName dari struktur NETRESOURCE yang diarahkan oleh parameter lpNetResource tidak menentukan perangkat yang dialihkan, atau anggota lpRemoteName tidak menentukan nama sumber daya yang saat ini tersambung.
ERROR_NO_NET_OR_BAD_PATH	Operasi tidak dapat diselesaikan, baik karena komponen jaringan tidak dimulai, atau karena nama sumber daya yang ditentukan tidak dikenali.
ERROR_BAD_DEVICE	Perangkat lokal yang ditentukan oleh anggota lpLocalName tidak valid.
ERROR_BAD_NET_NAME	Nama jaringan tidak dapat ditemukan. Kesalahan ini dikembalikan jika anggota lpLocalName dari struktur NETRESOURCE yang diacu oleh parameter lpNetResource adalah NULL dan anggota lpRemoteName dari struktur NETRESOURCE yang diacu oleh lpNetResource juga atau NULL atau tidak dapat dikenali oleh jaringan apa pun.
ERROR_INVALID_ADDRESS	Upaya untuk mengakses alamat yang tidak valid. Kesalahan ini dikembalikan jika parameter lpNetResource atau lpNetConnectInfoStructadalah NULL.
ERROR_INVALID_PARAMETER	Parameter yang buruk telah dilewati. Kesalahan ini dikembalikan jika parameter lpNetConnectInfoStruct tidak menunjuk ke struktur NETCONNECTINFOSTRUCT tempat anggota cbStructure diisi dengan ukuran struktur yang tepat.
ERROR_NO_NETWORK	Jaringan tidak tersedia.
ERROR_EXTENDED_ERROR	Terjadi kesalahan khusus jaringan. Untuk mendapatkan deskripsi kesalahan, panggil WNetGetLastError.

Keterangan

Fungsi MultinetGetConnectionPerformance mengembalikan informasi dalam struktur NETCONNECTINFOSTRUCT .

Informasi yang dikembalikan oleh fungsi MultinetGetConnectionPerformance hanya perkiraan. Lalu lintas dan perutean jaringan dapat memengaruhi akurasi hasil yang dikembalikan.

Perhatikan bahwa fungsi MultinetGetConnectionPerformance hanya dapat digunakan untuk meminta informasi untuk perangkat lokal yang dialihkan ke sumber daya jaringan, atau untuk sumber daya jaringan yang saat ini ada koneksi.

Jika jalur UNC ditentukan dalam anggota lpRemoteName dari struktur NETRESOURCE yang diarahkan oleh parameter lpNetResource , anggota lpRemoteName harus berupa nama direktori, bukan nama file.

Cara umum untuk menggunakan fungsi ini adalah dengan membuka file di server jaringan (yang akan memastikan bahwa ada koneksi ke file), memanggil fungsi ini, dan menggunakan hasilnya untuk membuat keputusan tentang cara mengelola I/O file. Misalnya, Anda dapat memutuskan apakah akan membaca seluruh file ke dalam file sementara pada klien atau langsung mengakses file di server.

Catatan

Header winnetwk.h mendefinisikan MultinetGetConnectionPerformance sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winnetwk.h
Pustaka	Mpr.lib
DLL	Mpr.dll

Lihat juga

NETCONNECTINFOSTRUCT

SUMBER DAYA NET

Gambaran Umum Windows Networking (WNet)

Fungsi Jaringan Windows