Fungsi WNetGetProviderNameA (winnetwk.h)

  • Artikel

Fungsi WNetGetProviderName mendapatkan nama penyedia untuk jenis jaringan tertentu.

Sintaks

DWORD WNetGetProviderNameA(
  [in]      DWORD   dwNetType,
  [out]     LPSTR   lpProviderName,
  [in, out] LPDWORD lpBufferSize
);

Parameter

[in] dwNetType

Jenis jaringan yang unik untuk jaringan. Jika dua jaringan mengklaim jenis yang sama, fungsi mengembalikan nama penyedia yang dimuat terlebih dahulu. Hanya kata tinggi dari jenis jaringan yang digunakan. Jika jaringan melaporkan subjenis dengan kata rendah, itu diabaikan.

Anda dapat menemukan daftar lengkap jenis jaringan dalam file header Winnetwk.h.

[out] lpProviderName

Penunjuk ke buffer yang menerima nama penyedia jaringan.

[in, out] lpBufferSize

Ukuran buffer yang diteruskan ke fungsi, dalam karakter. Jika nilai yang dikembalikan ERROR_MORE_DATA, lpBufferSize mengembalikan ukuran buffer yang diperlukan (dalam karakter) untuk menahan nama penyedia.

Windows Me/98/95: Ukuran buffer dalam byte, bukan karakter. Selain itu, buffer harus setidaknya 1 byte panjang.

Mengembalikan nilai

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_MORE_DATA
 Buffer terlalu kecil untuk menahan nama penyedia jaringan.
ERROR_NO_NETWORK
 Jaringan tidak tersedia.
ERROR_INVALID_ADDRESS
 Parameter lpProviderName atau parameter lpBufferSize tidak valid.

Keterangan

Catatan

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

Persyaratan Nilai
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

WNetGetNetworkInformation

WNetGetResourceInformation

WNetGetUniversalName

Gambaran Umum Windows Networking (WNet)

Fungsi Jaringan Windows