※ XingAPI COM 버전

  1. Visual C++ 6.0 을 이용하여 ATL로 제작되었습니다.

  2. 3개의 콤포넌트로 제작되었고 대부분의 XingAPI DLL의 기능을 지원합니다.

  3. XingAPI DLL을 Rapping 하여 개발되었으므로 XingAPI DLL버전 관련 파일과 같은 폴더에 있어야 합니다.

 

※ XingAPI COM 버전의 장점

  1. COM(혹은 ActiveX)를 지원하는 윈도우즈 프로그래밍 언어(Excel도 가능)에서 XingAPI를 사용하실 수 있습니다.

  2. XingAPI DLL 버전의 어려운 개념을 내부적으로 처리하므로 개발이 쉽습니다.

  3. 10여개의 Property/Method/Event로 개발이 가능합니다.

 

※ Res 파일

  - Res 파일은 TR구조를 정의한 파일입니다.

  - DLL버전에서 사용하는 구조체를 사용하는 대신 Res 파일을 사용합니다.

  - XAQuery / XAReal 에서 Res 파일을 입력해주면(ResFileName / LoadFromResFile) Component가 Res 파일을 분석하게 되고

   이후에는 Block명과 Field명으로 접근을 할 수 있게 됩니다.

  - Res 파일은 COM 버전 파일이 있는 폴더에 같이 있거나 하위 폴더에 있어야 합니다.

 

※ XingAPI COM 버전 Component 설명 및 Property / Method / Event 설명

  1. XASession

    - Connect / Login / Logout 을 처리합니다.

    - 기타 Utility Function 을 제공합니다.

　이름설명반환값인자참조
PropertyConnectTimeOut서버연결시도시간 (1/1000초단위), 기본값은 -1(10초)　　ETK_Connect()
SendPacketSize전송 Packet Size, 기본값은 -1　　ETK_Connect()
MethodIsLoadAPIX-ing API DLL의 초기화 여부를 반환합니다.
False를 반환할 경우 XingAPI DLL의 위치를 확인하세요		True : 초기화 되어있음
False : 초기화가 되어있지 않음		-　
ConnectServer서버와 연결합니다. True : 연결성공
False : 연결실패		szServerIP : 서버주소
szServerPort : 서버포트		ETK_Connect()
DisconnectServer서버와 연결을 종료합니다. --ETK_Disconnect()
IsConnected서버와의 연결여부를 반환합니다. True : 연결되어있음
False : 연결되어있지않음		-ETK_IsConnected()
Login서버에 로그인합니다. True : 로그인 전송성공
False : 로그인 전송실패		szID : 사용자 아이디
szPwd : 사용자 비밀번호
szCertPwd : 공인인증 비밀번호
nServerType : 서버Type
bShowCertErrDlg : 공인인증에러화면표시		ETK_Login()
Logout서버에서 로그아웃합니다. True : 로그인 전송성공
False : 로그인 전송실패		-ETK_Logout()
GetAccountListCount계좌의 개수를 반환합니다. 계좌 개수-ETK_GetAccountListCount()
GetAccountList계좌번호를 반환합니다. 계좌번호nIndex : 계좌번호 인덱스ETK_GetAccountList()
GetETKMediaETK_GetETKMedia()당사매체-ETK_GetETKMedia()
GetCommMedia통신매체를 반환합니다. 통신매체-ETK_GetCommMedia()
GetServerName접속한 서버의 이름을 반환합니다. 접속서버명-ETK_GetServerName()
GetClientIPPC의 IP를 반환합니다. PC IP-ETK_GetClientIP()
GetLastError마지막에 발생한 Error Code를 반환합니다. Error Code-ETK_GetLastError()
GetErrorMessageError Code에 대한 메시지를 반환합니다. 에러 메시지nErrorCodeETK_GetErrorMessage()
EventDisconnect서버와의 연결이 끊어졌을때 발생합니다. 　-XM_DISCONNECT
Login서버와의 로그인이 끝나면 발생합니다. 　szCode : 코드
szMsg : 메시지		XM_LOGIN
Logout서버와의 로그아웃이 끝나면 발생합니다. 　-XM_LOGOUT

 

  2. XAQuery

    - 조회TR을 처리합니다.

    - 한개의 Object는 지정된 하나의 TR만 처리할 수 있습니다.

    - 하나의 조회(서버전송->서버수신)이 완료된 이후에 다음 조회를 할 수 있습니다.

      만약 동시에 여러개의 조회를 전송하려면 전송하려는 수만큼 Object를 생성해야 합니다.

    - 수신된 데이터는 다음 조회까지 데이터를 가지고 있습니다.

    - Data Type 에 의존하지 않으므로 DLL버전처럼 데이터를 처리하지 않습니다.

　이름설명반환값인자참조
PropertyResFileName RES 파일을 지정 　　　
IsNext연속조회 여부, 연속조회가 있는지 확인할때 사용합니다.　　　
MethodLoadFromResFileRES 파일을 지정 True : 성공
False : 실패		szFileName : Res 파일명　
GetFieldDataBlock의 Field Data를 취득한다. DataszBlockName : Block명
szFieldName : Field명
nOccursIndex : Block의 Occurs Index		　
SetFieldDataBlock의 Field Data를 설정한다. -szBlockName : Block명
szFieldName : Field명
nOccursIndex : Block의 Occurs Index
szData : Data		　
GetBlockCountBlock이 Occurs 일 경우 Occurs의 개수를 취득한다.Block 안의 Occurs 개수-　
SetBlockCountBlock의 개수를 설정한다. InBlock 시에만 사용한다.-Block 안의 Occurs 개수　
Request조회TR을 요청한다. True : 성공
False : 실패		bNext : 다음조회일 경우는 TRUE
          그렇지 않으면 FALSE		ETK_Request()
ClearBlock지정한 Block 의 내용을 삭제한다.-szBlockName : Block 명　
EventReceiveData서버로부터 데이터를 수신했을때의 이벤트--XM_RECEIVE_DATA
ReceiveMessage서버로부터 메시지를 수신했을때의 이벤트-bIsSystemError
szMessageCode
szMessage		XM_RECEIVE_DATA

 

  3. XAReal

    - 실시간TR을 처리합니다.

    - 수신된 데이터는 다음 데이터가 수신될때까지 유지합니다.

    - Data Type 에 의존하지 않으므로 DLL버전처럼 데이터를 처리하지 않습니다.

　이름설명반환값인자참조
PropertyResFileName RES 파일을 지정 　　　
MethodLoadFromResFileRES 파일을 지정 True : 성공
False : 실패		szFileName : Res 파일명　
AdviseRealDataTR 등록--ETK_AdviseRealData()
UnadviseRealData TR 해제--ETK_UnadviseRealData()
GetFieldData Block 의 Field Data를 취득한다.DataszBlockName : Block명
szFieldName : Field명		　
SetFieldData Block 의 Field Data를 설정한다.-szBlockName : Block명
szFieldName : Field명
szData : Data		　
EventReceiveRealData서버로부터 데이터를 수신했을때의 이벤트　-
이 게시물을