Fungsi WNetGetNetworkInformationA (winnetwk.h)

2024-11-20

Fungsi WNetGetNetworkInformation mengembalikan informasi yang diperluas tentang penyedia jaringan tertentu yang namanya dikembalikan oleh enumerasi jaringan sebelumnya.

Sintaksis

DWORD WNetGetNetworkInformationA(
  [in]  LPCSTR          lpProvider,
  [out] LPNETINFOSTRUCT lpNetInfoStruct
);

Parameter

[in] lpProvider

Penunjuk ke string konstanta yang dihentikan null yang berisi nama penyedia jaringan yang informasinya diperlukan.

[out] lpNetInfoStruct

Penunjuk ke struktur NETINFOSTRUCT . Struktur menjelaskan karakteristik jaringan.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.

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

Mengembalikan kode	Deskripsi
ERROR_BAD_PROVIDER	Parameter lpProvider tidak cocok dengan penyedia jaringan yang sedang berjalan.
ERROR_BAD_VALUE	cbStructure anggota struktur NETINFOSTRUCT tidak berisi ukuran struktur yang valid.

Komentar

Nota

Header winnetwk.h mendefinisikan WNetGetNetworkInformation 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

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

Lihat juga

NETINFOSTRUCT

NETRESOURCE

WNetEnumResource

WNetGetProviderName

WNetOpenEnum

Gambaran Umum Windows Networking (WNet)

Fungsi Jaringan Windows