Fungsi WSANtohs (winsock2.h)

Artikel
08/27/2023

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

Sintaks

int WSAAPI WSANtohs(
  [in]  SOCKET  s,
  [in]  u_short netshort,
  [out] u_short *lphostshort
);

Parameter

[in] s

Deskriptor yang mengidentifikasi soket.

[in] netshort

Angka 16-bit dalam urutan byte jaringan.

[out] lphostshort

Pointer ke angka 16-bit untuk menerima nomor dalam urutan byte host.

Mengembalikan nilai

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

Keterangan

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

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