ETK_Connect |
|
|
|
| 서버와 연결합니다. |
|
|
구문 |
|
|
BOOL __stdcall ETK_Connect (
HWND hWnd,
const char* pszSvr,
int nPort,
int nStartMsgID,
int nTimeOut,
int nSendMaxPacketSize
)
|
|
|
|
매개변수 |
|
| hWnd
Window Handle.
pszSvr
연결할 서버 IP
nPort
연결할 서버 Port
nStartMsgID
시작 MessageID
nTimeOut
연결시도 시간 - millisecond단위(1/1000초), -1 은 기본값(10초)으로 설정
nSendMaxPacketSize
전송시 최대 Packet Size, -1은 기본값으로 설정
|
|
|
반환값 |
|
| 0(FALSE) 이면 실패
1(TRUE) 이면 성공
실패시 ETK_GetLastError() 로 실패코드를 얻을 수 있습니다.
- 실패코드 -
XINGAPI_ERROR_SOCKET_CREATE_FAIL | 소켓생성 실패 | XINGAPI_ERROR_CONNECT_FAIL | 서버연결 실패 | XINGAPI_ERROR_WRONG_ADDRESS | 서버주소가 잘못되었음 | XINGAPI_ERROR_CONNECT_TIMEOUT | 연결시간 초과 | XINGAPI_ERROR_ALREADY_CONNECT | 이미 서버에 연결중이거나 연결시도중 |
|
|
|
설명 |
|
| hWnd 는 XM_DISCONNECT를 보낼 때 여기에 등록한 윈도우로 보내게 됩니다.
nStartMsgID 는 Client 로 보낼 Message 의 시작 ID를 지정합니다.
Microsoft Windows는 사용자 Message를 사용할 수 있으며
0x400(=WM_USER) 이상의 Message를 사용할 수 있습니다.
그러므로 nStartMsgID는 0x400(=1024) 이상의 값이 들어와야 합니다.
Client 로 정의된 Message를 보낼 때는 nStartMsgID + 정의된 MessageID 로 보내게 됩니다.
예) XM_RECEIVE_DATA를 보낼 때는 nStartMsgID + XM_RECEIVE_DATA 로 보내게 됩니다.
nTimeOut 은 연결시도시간이며 이 시간이 초과할때까지 연결이 이루어지지 않으면 실패하게 됩니다.
기본값을 사용하되 인터넷이 느리거나 불안해서 Timeout 이 발생할 경우 사용하시기 바랍니다.
nSendPacketSize는 전송시 한번에 보낼 수 있는 최대 Data Size 입니다.
이 값을 설정하게 되면 설정한 크기 이상의 데이터를 전송할 경우 여러 번에 걸쳐서 전송하게 됩니다.
보통은 기본값을 사용하면 되나,
인터넷 공유기 등에서 최대 전송 Data Size를 제한하는 경우가 있으므로
전송 실패가 나는 경우에 최대 전송 Data Size 만큼 설정하시면 전송이 가능해질 수 있습니다.
|
|
|
예제 |
|
|
Visual C++ | BOOL bConnect = ETK_Connect( GetSafeHwnd(), "hts.etrade.co.kr", 20001, WM_USER, 10, -1 );
if( bConnect == FALSE )
{
MessageBox( "서버연결에 실패하였습니다.", "연결실패", MB_ICONSTOP );
}
else
{
MessageBox( "서버와 연결되었습니다.", "연결성공", MB_ICONINFORMATION );
}
|
Visual Basic | bConnect = ETK_Connect( hwnd, "hts.etrade.co.kr", 20001, 1024, 10, -1 )
if bConnect = False then
msgbox "서버연결에 실패하였습니다."
else
msgbox "서버와 연결되었습니다."
end if
|
|
|
|
참고항목 |
|
| ETK_IsConnected()
ETK_Disconnect()
|