共用方式為


WSANtohs 函式 (winsock2.h)

WSANtohs 函式會將u_short從網路位元組順序轉換為主機位元組順序。

語法

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

參數

[in] s

識別套接字的描述項。

[in] netshort

以網路位元組順序表示的16位數位。

[out] lphostshort

以主機位元組順序接收數位的16位數位指標。

傳回值

如果沒有發生錯誤, WSANtohs 會傳回零。 否則,會傳回SOCKET_ERROR的值,並呼叫 WSAGetLastError 來擷取特定的錯誤碼。

錯誤碼 意義
WSANOTINITIALISED
使用這個函式之前,必須先進行成功的 WSAStartup 呼叫。
WSAENETDOWN
網路子系統失敗。
WSAENOTSOCK
描述項不是套接字。
WSAEFAULT
lphostshort 參數為 NULL,或指向的位址未完全包含在使用者位址空間的有效部分。

備註

WSANtohs 函式會採用網路位元組順序中的16位數位,並以 lphostshort 參數所指向的16位數位,以主機位元組順序傳回16位數位。 傳入 s 參數的套接字可用來根據與套接字相關聯的 Winsock 目錄通訊協定項目來判斷所需的網路位元組順序。 此功能支援使用不同網路位元組訂單的 Winsock 提供者。

如果套接字適用於AF_INET或AF_INET6位址系列, 則 WSANtohs 函式可用來依網路位元組順序將IP埠號碼轉換成主機位元組順序的IP埠號碼。

WSANtohs 函式要求先前已載入 Winsock DLL 並成功呼叫 WSAStartup 函式。 若要搭配 AF_INET OR AF_INET6 位址系列使用, ntohs 函式不需要載入 Winsock DLL。

Windows Phone 8:Windows Phone 8 和更新版本上的 Windows Phone Store 應用程式支援此函式。

Windows 8.1Windows Server 2012 R2:Windows 8.1、Windows Server 2012 R2 及更新版本上的 Windows 市集應用程式支援此函式。

規格需求

需求
最低支援的用戶端 Windows 8.1、Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 winsock2.h
程式庫 Ws2_32.lib
Dll Ws2_32.dll

另請參閱

InetNtop

WSAHtonl

WSAHtons

WSANtohl

Winsock 函式

Winsock 參考

htonl

htons

inet_addr

inet_ntoa

ntohl

ntohs