WinSocketAPI.h 파일 참조

#include <WinSock2.h>
#include <MSWSock.h>
#include <WS2tcpip.h>
#include "CommTypes.h"

이 파일의 소스 코드 페이지로 가기

매크로
#define	IN   /* marks input param */
#define	OUT   /* marks output param */
#define	INOUT   /* marks input+output param */

함수
int	InitWindowSocketLib (LPWSADATA)
SOCKET	CreateWindowSocket_IPv4 (bool isTCP, OUT int *errCode=NULL)
SOCKADDR_IN	CreateDestinationADDR (const char *destIP, uint16 destPort)
SOCKADDR_IN	CreateDestinationADDR (IN_ADDR destInAddr, uint16 destPort)
SOCKADDR_IN	CreateDestinationADDR_LoopBack (uint16 destPort)
SOCKADDR_IN	CreateDestinationADDR_byDomain (WCHAR *destDomain, uint16 destPort)
bool	ConnectToDestination (const SOCKET &sock, const SOCKADDR_IN &destAddr, OUT int *errCode=NULL)
SOCKADDR_IN	CreateServerADDR (const char *serverIp, uint16 port)
SOCKADDR_IN	CreateServerADDR_ANY (uint16 port)
SOCKADDR_IN	CreateServerADDR_LoopBack (uint16 port)
bool	BindSocket (SOCKET &sock, SOCKADDR_IN &serverAddr, OUT int *errCode=NULL)
bool	ListenSocket (SOCKET &sock, int backlog, OUT int *errCode=NULL)
SOCKET	AcceptSocket (SOCKET &sock, SOCKADDR_IN &clientAddr, OUT int *errCode=NULL)
void	IN_ADDR_TO_STRING (const IN_ADDR &inAddr, char ipStr[INET_ADDRSTRLEN])
bool	DomainAddrToIP (WCHAR *szDomain, IN_ADDR *pAddr)

매크로 문서화

IN

#define IN   /* marks input param */

OUT

#define OUT   /* marks output param */

INOUT

#define INOUT   /* marks input+output param */

함수 문서화

InitWindowSocketLib()

int InitWindowSocketLib

(

LPWSADATA

pWsaData

)

{
    // winsock.h 
    // Windows 소켓 함수들을 호출하기 전 첫 번째로 호출되어야 하는 초기화 함수
    // (ws2_32 라이브러리 초기화)
    // 또한 소켓 구현의 세부 정보를 담는 WSADATA 데이터 획득
    return ::WSAStartup(MAKEWORD(2, 2), pWsaData);
    // 성공 시 0 반환
    // 실패 시 오류 코드 반환
}

CreateWindowSocket_IPv4()

SOCKET CreateWindowSocket_IPv4	(	bool	isTCP,
		OUT int *	errCode = NULL )

CreateDestinationADDR() [1/2]

SOCKADDR_IN CreateDestinationADDR	(	const char *	destIP,
		uint16	destPort )

{
    SOCKADDR_IN destAddr;
    (void)memset(&destAddr, 0, sizeof(destAddr));
    destAddr.sin_family = AF_INET;
    //serverAddr.sin_addr.S_un.S_addr = ::inet_addr("127.0.0.1");
    //                    // ULONG S_addr;
    //                    // 4바이트 정수로 IPv4 주소 표현
    // 위 방식은 구식적인 방법, deprecate API warnings 발생! 아래와 같이 설정
    ::inet_pton(AF_INET, destIP, &destAddr.sin_addr);
    destAddr.sin_port = ::htons(destPort);
    // host to network short
    // 호스트의 리틀 앤디안을 네트워크의 빅 엔디안 표기로
 
    return destAddr;
}

CreateDestinationADDR() [2/2]

SOCKADDR_IN CreateDestinationADDR	(	IN_ADDR	destInAddr,
		uint16	destPort )

{
    SOCKADDR_IN destAddr;
    (void)memset(&destAddr, 0, sizeof(destAddr));
 
    destAddr.sin_family = AF_INET;
    destAddr.sin_addr = destInAddr;
    destAddr.sin_port = ::htons(destPort);
 
    return destAddr;
}

CreateDestinationADDR_LoopBack()

SOCKADDR_IN CreateDestinationADDR_LoopBack

(

uint16

destPort

)

                                                            {
    return CreateDestinationADDR("127.0.0.1", destPort);
}

CreateDestinationADDR_byDomain()

SOCKADDR_IN CreateDestinationADDR_byDomain	(	WCHAR *	destDomain,
		uint16	destPort )

{
    IN_ADDR inAddr;
    DomainAddrToIP(destDomain, &inAddr);
    return CreateDestinationADDR(inAddr, destPort);
}

ConnectToDestination()

bool ConnectToDestination	(	const SOCKET &	sock,
		const SOCKADDR_IN &	destAddr,
		OUT int *	errCode = NULL )

CreateServerADDR()

SOCKADDR_IN CreateServerADDR	(	const char *	serverIp,
		uint16	port )

{
    SOCKADDR_IN serverAddr;
    (void)memset(&serverAddr, 0, sizeof(serverAddr));
    serverAddr.sin_family = AF_INET;
 
    ::inet_pton(AF_INET, serverIP, &serverAddr.sin_addr);
 
    // ::htonl(INADDR_ANY);
    // 서버의 네트워크 카드가 여러 개인 경우 주소가 여러 개 존재
    // 이 때 하드코딩하여 서버의 주소를 고정시킬 경우 이 주소로만 연결될 것
    // 하지만 INADDR_ANY 인자를 전달하여 루프백 주소를 포함하여 연결될 수 있는
    // 모든 주소를 연결할 수 있게 만든다.
    // 루프백 주소도 포함된다. 
 
    serverAddr.sin_port = ::htons(port);
    // host to network short
    // 호스트의 리틀 앤디안을 네트워크의 빅 엔디안 표기로
 
    return serverAddr;
}

CreateServerADDR_ANY()

SOCKADDR_IN CreateServerADDR_ANY

(

uint16

port

)

{
    SOCKADDR_IN serverAddr;
    (void)memset(&serverAddr, 0, sizeof(serverAddr));
    serverAddr.sin_family = AF_INET;
 
    serverAddr.sin_addr.S_un.S_addr = ::htonl(INADDR_ANY);
    //const char serverIP[] = "172.30.1.100";
    //::inet_pton(AF_INET, serverIP, &serverAddr.sin_addr);
 
    // ::htonl(INADDR_ANY);
    // 서버의 네트워크 카드가 여러 개인 경우 주소가 여러 개 존재
    // 이 때 하드코딩하여 서버의 주소를 고정시킬 경우 이 주소로만 연결될 것
    // 하지만 INADDR_ANY 인자를 전달하여 루프백 주소를 포함하여 연결될 수 있는
    // 모든 주소를 연결할 수 있게 만든다.
    // 루프백 주소도 포함된다. 
 
    serverAddr.sin_port = ::htons(port);
    // host to network short
    // 호스트의 리틀 앤디안을 네트워크의 빅 엔디안 표기로
 
    return serverAddr;
}

CreateServerADDR_LoopBack()

SOCKADDR_IN CreateServerADDR_LoopBack

(

uint16

port

)

                                                   {
    return CreateServerADDR("127.0.0.1", port);
}

BindSocket()

bool BindSocket	(	SOCKET &	sock,
		SOCKADDR_IN &	serverAddr,
		OUT int *	errCode = NULL )

ListenSocket()

bool ListenSocket	(	SOCKET &	sock,
		int	backlog,
		OUT int *	errCode = NULL )

AcceptSocket()

SOCKET AcceptSocket	(	SOCKET &	sock,
		SOCKADDR_IN &	clientAddr,
		OUT int *	errCode = NULL )

IN_ADDR_TO_STRING()

void IN_ADDR_TO_STRING	(	const IN_ADDR &	inAddr,
		char	ipStr[INET_ADDRSTRLEN] )

DomainAddrToIP()

bool DomainAddrToIP	(	WCHAR *	szDomain,
		IN_ADDR *	pAddr )

{
    ADDRINFOW* pAddrInfo;
    SOCKADDR_IN* pSockAddr;
    if (GetAddrInfo(szDomain, L"0", NULL, &pAddrInfo) != 0) {
        return FALSE;
    }
    else {
        pSockAddr = (SOCKADDR_IN*)pAddrInfo->ai_addr;
        *pAddr = pSockAddr->sin_addr;
        FreeAddrInfo(pAddrInfo);
 
        return TRUE;
    }
}