WSANtohl 함수(winsock2.h)

아티클
08/27/2023

WSANtohl 함수는 u_long 네트워크 바이트 순서에서 호스트 바이트 순서로 변환합니다.

구문

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

매개 변수

[in] s

소켓을 식별하는 설명자입니다.

[in] netlong

네트워크 바이트 순서의 32비트 숫자입니다.

[out] lphostlong

호스트 바이트 순서로 숫자를 받을 32비트 숫자에 대한 포인터입니다.

반환 값

오류가 발생하지 않으면 WSANtohl 은 0을 반환합니다. 그렇지 않으면 SOCKET_ERROR 값이 반환되고 WSAGetLastError를 호출하여 특정 오류 코드를 검색할 수 있습니다.

오류 코드	의미
WSANOTINITIALISED	이 함수를 사용하기 전에 성공적인 WSAStartup 호출이 발생해야 합니다.
WSAENETDOWN	네트워크 하위 시스템이 실패했습니다.
WSAENOTSOCK	설명자가 소켓이 아닙니다.
WSAEFAULT	lphostlong 매개 변수가 NULL이거나 가리키는 주소가 사용자 주소 공간의 유효한 부분에 완전히 포함되지 않습니다.

설명

WSANtohl 함수는 네트워크 바이트 순서로 32비트 숫자를 사용하고 lphostlong 매개 변수가 가리키는 32비트 숫자의 호스트 바이트 순서로 32비트 숫자를 반환합니다. s 매개 변수에 전달된 소켓은 소켓과 연결된 Winsock 카탈로그 프로토콜 항목에 따라 필요한 네트워크 바이트 순서를 결정하는 데 사용됩니다. 이 기능은 다양한 네트워크 바이트 주문을 사용하는 Winsock 공급자를 지원합니다.

소켓이 AF_INET 또는 AF_INET6 주소 패밀리용인 경우 WSANtohl 함수를 사용하여 네트워크 바이트 순서의 IPv4 주소를 호스트 바이트 순서의 IPv4 주소로 변환할 수 있습니다. 이 함수는 netlong 매개 변수가 유효한 IPv4 주소인지 확인하기 위해 검사를 수행하지 않습니다.

WSANtohl 함수를 사용하려면 Winsock DLL이 이전에 WSAStartup 함수를 성공적으로 호출하여 로드되어야 합니다. AF_INET 또는 AF_INET6 패밀리와 함께 사용하기 위해 ntohl 함수는 Winsock DLL을 로드할 필요가 없습니다.

Windows Phone 8: 이 함수는 Windows Phone 8 이상에서 Windows Phone 스토어 앱에서 지원됩니다.

Windows 8.1 및 Windows 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