WA-SDK  3.0.4.0
WA-SDK
system_network.h 파일 참조

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

매크로

#define SOCKET   int
 
#define INVALID_SOCKET   (-1)
 
#define SOCKET_ERROR   (-1)
 
#define closesocket(s)   close(s)
 
#define MAX_MESSAGE_LEN   (10 * 1024 * 1024)
 

열거형 타입

enum  { ER_SYSTEM_NETWORK_FAIL_TO_RESOLVE_HOSTNAME = -200 , ER_SYSTEM_NETWORK_FAIL_TO_CREATE_SOCKET , ER_SYSTEM_NETWORK_FAIL_TO_CONNECT }
 
enum  { ER_SYSTEM_NETWORK_FAIL_TO_SEND = -200 , ER_SYSTEM_NETWORK_INVALID_PKIMESSAGE }
 
enum  {
  ER_SYSTEM_NETWORK_FAIL_TO_RECEIVE = -200 , ER_SYSTEM_NETWORK_UNKNOWN_PROTOCOL , ER_SYSTEM_NETWORK_ERRORMSG_RECEIVED , ER_SYSTEM_NETWORK_INVALID_PKIMESSAGE_RECEIVED ,
  ER_SYSTEM_NETWORK_MESSAGE_TO_LARGE
}
 

함수

int Network_Init ()
 
SOCKET Network_Connect (const char *ip, int port)
 
int NetWork_GetPeerName (char *szPeerName, SOCKET sock)
 
void Network_Close (SOCKET sock)
 
int Network_SendPKIMessage (SOCKET sock, PKIMessage *pPKIMessage)
 
int Network_RecvPKIMessage (PKIMessage **ppPKIMessage, SOCKET sock, char *pszErrorMsgBuf, int nMaxBufLen)
 

매크로 문서화

◆ SOCKET

#define SOCKET   int

◆ INVALID_SOCKET

#define INVALID_SOCKET   (-1)

◆ SOCKET_ERROR

#define SOCKET_ERROR   (-1)

◆ closesocket

#define closesocket (   s)    close(s)

◆ MAX_MESSAGE_LEN

#define MAX_MESSAGE_LEN   (10 * 1024 * 1024)

열거형 타입 문서화

◆ anonymous enum

anonymous enum

주어진 ip와 port값을 이용하여 socket을 생성하여 서버와 연결한 뒤, 해당 socket값을 리턴한다.

매개변수
*ip(In) 서버의 ip 값
port(In) 서버의 port 값
반환값
  • 성공시 해당 socket 값, 실패시 음수값 리턴
참고
Network_Close
열거형 멤버
ER_SYSTEM_NETWORK_FAIL_TO_RESOLVE_HOSTNAME 

Host 이름 해석 실패

ER_SYSTEM_NETWORK_FAIL_TO_CREATE_SOCKET 

Socket 생성 실패

ER_SYSTEM_NETWORK_FAIL_TO_CONNECT 

연결 실패

◆ anonymous enum

anonymous enum

PKIMessage를 전송한다. RFC2510(March 1999) 5.2 참조

매개변수
sock(In) Network_Connect에 의해 성생된 socket
pPKIMessage(In) 전송할 PKIMessage
반환값
  • SUCCESS : 성공
참고
Network_Connect
열거형 멤버
ER_SYSTEM_NETWORK_FAIL_TO_SEND 

Network 상의 문제로 인한 메시지 송신 실패

ER_SYSTEM_NETWORK_INVALID_PKIMESSAGE 

잘못된 PKIMessage

◆ anonymous enum

anonymous enum

PKIMessage를 수신한다. RFC2510(March 1999) 5.2 참조

매개변수
ppPKIMessage(Out) 수신된 PKIMessage
sock(In) Network_Connect에 의해 성생된 socket
pszErrorMsgBuf(In) 에러 메시지(0x06)가 수신된 경우, 추가 메시지가 저장될 버퍼 (pszErrorMsgBuf가 NULL이면 저장하지 않음) 이때 return 값은 ER_SYSTEM_NETWORK_ERRORMSG_RECEIVED이 된다.
nMaxBufLen(In) pszErrorMsgBuf의 최대 크기
반환값
  • SUCCESS : 성공
참고
Network_Connect
열거형 멤버
ER_SYSTEM_NETWORK_FAIL_TO_RECEIVE 

Network 상의 문제로 인한 메시지 수신 실패

ER_SYSTEM_NETWORK_UNKNOWN_PROTOCOL 

이해할 수 없는 방식의 데이터가 수신된 경우

ER_SYSTEM_NETWORK_ERRORMSG_RECEIVED 

에러 메시지(flag 0x06)가 수신된 경우

ER_SYSTEM_NETWORK_INVALID_PKIMESSAGE_RECEIVED 

잘못된 형식의 PKIMessage가 수신된 경우

ER_SYSTEM_NETWORK_MESSAGE_TO_LARGE 

메시지 크기가 너무 큰 경우(10M 초과)

함수 문서화

◆ Network_Init()

int Network_Init ( )

Network를 초기화한다(Win32)

◆ Network_Connect()

SOCKET Network_Connect ( const char *  ip,
int  port 
)

◆ NetWork_GetPeerName()

int NetWork_GetPeerName ( char *  szPeerName,
SOCKET  sock 
)

socket값으로부터 요청자의 주소 값을 얻는다.

매개변수
*szPeerName(Out) 주소 값이 저장될 버퍼, 실패시에는 공백문자가 저장된다.
sock(In) socket
반환값
  • SUCCESS : 성공
  • FAIL : 실패

◆ Network_Close()

void Network_Close ( SOCKET  sock)

Network_Connect에 의해 생성된 연결을 끊는다.

매개변수
sock(In) Network_Connect에 의해 성생된 socket
참고
Network_Connect

◆ Network_SendPKIMessage()

int Network_SendPKIMessage ( SOCKET  sock,
PKIMessage *  pPKIMessage 
)

◆ Network_RecvPKIMessage()

int Network_RecvPKIMessage ( PKIMessage **  ppPKIMessage,
SOCKET  sock,
char *  pszErrorMsgBuf,
int  nMaxBufLen 
)