Fungsi WSAHtons (winsock2.h)

Artikel
03/13/2024

Fungsi WSAHtons mengonversi u_short dari urutan byte host ke urutan byte jaringan.

Sintaks

int WSAAPI WSAHtons(
  [in]  SOCKET  s,
  [in]  u_short hostshort,
  [out] u_short *lpnetshort
);

Parameter

[in] s

Deskriptor yang mengidentifikasi soket.

[in] hostshort

Angka 16-bit dalam urutan byte host.

[out] lpnetshort

Penunjuk ke buffer 16-bit untuk menerima angka dalam urutan byte jaringan.

Mengembalikan nilai

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

Keterangan

Fungsi WSAHtons mengambil angka 16-bit dalam urutan byte host dan mengembalikan angka 16-bit dalam urutan byte jaringan dalam angka 16-bit yang ditunjukkan oleh parameter lpnetshort . 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 WSAHtons dapat digunakan untuk mengonversi nomor port IP dalam urutan byte host ke nomor port IP dalam urutan byte jaringan.

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

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