Fungsi WNetGetProviderNameA (winnetwk.h)
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 |
---|---|
|
Buffer terlalu kecil untuk menahan nama penyedia jaringan. |
|
Jaringan tidak tersedia. |
|
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk