Fungsi WSAHtonl (winsock2.h)

Artikel
08/27/2023

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

Sintaks

int WSAAPI WSAHtonl(
  [in]  SOCKET s,
  [in]  u_long hostlong,
  [out] u_long *lpnetlong
);

Parameter

[in] s

Deskriptor yang mengidentifikasi soket.

[in] hostlong

Angka 32-bit dalam urutan byte host.

[out] lpnetlong

Pointer ke angka 32-bit untuk menerima angka dalam urutan byte jaringan.

Menampilkan nilai

Jika tidak ada kesalahan yang terjadi, WSAHtonl 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 lpnetlong adalah NULL atau alamat yang ditujukan tidak sepenuhnya terkandung dalam bagian ruang alamat pengguna yang valid.

Keterangan

Fungsi WSAHtonl mengambil angka 32-bit dalam urutan byte host dan mengembalikan angka 32-bit dalam urutan byte jaringan dalam angka 32-bit yang ditunjukkan oleh parameter lpnetlong . 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 WSAHtonl dapat digunakan untuk mengonversi alamat IPv4 dalam urutan byte host ke alamat IPv4 dalam urutan byte jaringan. Fungsi ini tidak melakukan pemeriksaan apa pun untuk menentukan apakah parameter hostlong adalah alamat IPv4 yang valid.

Fungsi WSAHtonl mengharuskan Winsock DLL sebelumnya telah dimuat dengan panggilan yang berhasil ke fungsi WSAStartup . Untuk digunakan dengan keluarga AF_INET atau AF_INET6, fungsi htonl 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