Fungsi WSANtohl (winsock2.h)

Artikel
03/08/2023

Fungsi WSANtohl mengonversi u_long dari urutan byte jaringan ke urutan byte host.

Sintaks

int WSAAPI WSANtohl(
  [in]  SOCKET s,
  [in]  u_long netlong,
  [out] u_long *lphostlong
);

Parameter

[in] s

Deskriptor yang mengidentifikasi soket.

[in] netlong

Angka 32-bit dalam urutan byte jaringan.

[out] lphostlong

Penunjuk ke angka 32-bit untuk menerima angka dalam urutan byte host.

Menampilkan nilai

Jika tidak ada kesalahan yang terjadi, WSANtohl mengembalikan nol. Jika tidak, nilai SOCKET_ERROR dikembalikan, dan kode kesalahan tertentu dapat diambil dengan memanggil WSAGetLastError.

Kode kesalahan	Makna
WSANOTINITIALISED	Panggilan WSAStartup yang berhasil harus terjadi sebelum menggunakan fungsi ini.
WSAENETDOWN	Subsistem jaringan gagal.
WSAENOTSOCK	Deskriptor bukan soket.
WSAEFAULT	Parameter lphostlong adalah NULL atau alamat yang ditujukan tidak sepenuhnya terkandung dalam bagian ruang alamat pengguna yang valid.

Keterangan

Fungsi WSANtohl mengambil angka 32-bit dalam urutan byte jaringan dan mengembalikan angka 32-bit dalam urutan byte host dalam angka 32-bit yang diacu oleh parameter lphostlong . Soket yang diteruskan dalam parameter s digunakan untuk menentukan urutan byte jaringan yang diperlukan berdasarkan entri protokol katalog Winsock yang terkait dengan soket. Fitur ini mendukung penyedia Winsock yang menggunakan pesanan byte jaringan yang berbeda.

Jika soket adalah untuk keluarga alamat AF_INET atau AF_INET6, fungsi WSANtohl dapat digunakan untuk mengonversi alamat IPv4 dalam urutan byte jaringan ke alamat IPv4 dalam urutan byte host. Fungsi ini tidak melakukan pemeriksaan apa pun untuk menentukan apakah parameter netlong adalah alamat IPv4 yang valid.

Fungsi WSANtohl mengharuskan Winsock DLL sebelumnya telah dimuat dengan panggilan yang berhasil ke fungsi WSAStartup . Untuk digunakan dengan keluarga AF_INET atau AF_INET6, fungsi ntohl tidak mengharuskan Winsock DLL dimuat.

Windows Phone 8: Fungsi ini didukung untuk aplikasi Windows Phone Store di Windows Phone 8 dan yang lebih baru.

Windows 8.1 dan Windows Server 2012 R2: Fungsi ini didukung untuk aplikasi Windows Store di Windows 8.1, Windows Server 2012 R2, dan yang lebih baru.

Persyaratan


Klien minimum yang didukung	Windows 8.1, Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winsock2.h
Pustaka	Ws2_32.lib
DLL	Ws2_32.dll