2012.09.07 12:11
※ 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 설명

  이름 설명 반환값 인자 참조 

Property는 반환값, 매개변수가 없음
Method 대부분 반환값과 매개변수가 있음 (일부는 없음)
Event는 반환값이 없음

이름 설명
반환값
인자 참조


  1. XASession
    - Connect / Login / Logout 을 처리합니다.
    - 기타 Utility Function 을 제공합니다.

[Property]**********************************************************************************
ConnectTimeOut 서버연결시도시간 (1/1000초단위), 기본값은 -1(10초)    ETK_Connect() 
SendPacketSize 전송 Packet Size, 기본값은 -1     ETK_Connect() 

[Method]///////////////////////////////////////////////////////////////////////////////////
IsLoadAPI X-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() 
GetETKMedia ETK_GetETKMedia() 
당사매체 
- (매개변수없음) ETK_GetETKMedia() 
GetCommMedia 통신매체를 반환합니다.  
통신매체
- (매개변수없음) ETK_GetCommMedia() 
GetServerName 접속한 서버의 이름을 반환합니다.  
접속서버명
- ETK_GetServerName() 
GetClientIP PC의 IP를 반환합니다.  
PC IP
- (매개변수없음) ETK_GetClientIP() 
GetLastError 마지막에 발생한 Error Code를 반환합니다.  
Error Code
- (매개변수없음) ETK_GetLastError() 
GetErrorMessage Error Code에 대한 메시지를 반환합니다.  
에러 메시지
nErrorCode ETK_GetErrorMessage() 

[Event] ///////////////////////////////////////////////////////////////////////////////////
Disconnect 서버와의 연결이 끊어졌을때 발생합니다.    
- (매개변수없음) XM_DISCONNECT 
Login 서버와의 로그인이 끝나면 발생합니다. 
szCode : 코드
szMsg : 메시지 XM_LOGIN 
Logout 서버와의 로그아웃이 끝나면 발생합니다.    
- (매개변수없음) XM_LOGOUT 


  2. XAQuery
    - 조회TR을 처리합니다.
    - 한개의 Object는 지정된 하나의 TR만 처리할 수 있습니다.
    - 하나의 조회(서버전송->서버수신)이 완료된 이후에 다음 조회를 할 수 있습니다.
    - 만약 동시에 여러개의 조회를 전송하려면 전송하려는 수만큼 Object를 생성해야 합니다.
    - 수신된 데이터는 다음 조회까지 데이터를 가지고 있습니다.
    - Data Type 에 의존하지 않으므로 DLL버전처럼 데이터를 처리하지 않습니다.

[Property]************************************************************************
ResFileName   RES 파일을 지정  
IsNext 연속조회 여부, 연속조회가 있는지 확인할때 사용합니다. 

[Method]//////////////////////////////////////////////////////////////////////////////
LoadFromResFile RES 파일을 지정  
True : 성공
False : 실패
szFileName : Res 파일명   
GetFieldData Block의 Field Data를 취득한다.  
Data 
szBlockName : Block명
szFieldName : Field명
nOccursIndex : Block의 Occurs Index   
SetFieldData Block의 Field Data를 설정한다.  
- (반환값 없음)
szBlockName : Block명
szFieldName : Field명
nOccursIndex : Block의 Occurs Index
szData : Data   
GetBlockCount Block이 Occurs 일 경우 Occurs의 개수를 취득한다. 
Block 안의 Occurs 개수 
- (매개변수없음)
SetBlockCount Block의 개수를 설정한다. InBlock 시에만 사용한다. 
- (반환값 없음)
Block 안의 Occurs 개수   
Request 조회TR을 요청한다.  
True : 성공
False : 실패
bNext : 다음조회일 경우는 TRUE
          그렇지 않으면 FALSE ETK_Request() 
ClearBlock 지정한 Block 의 내용을 삭제한다. 
- (반환값 없음)
szBlockName : Block 명   
[Event]///////////////////////////////////////////////////////////////////
ReceiveData 서버로부터 데이터를 수신했을때의 이벤트 
- (반환값 없음)
- (매개변수없음) XM_RECEIVE_DATA 
ReceiveMessage 서버로부터 메시지를 수신했을때의 이벤트 
- (반환값 없음)
bIsSystemError
szMessageCode
szMessage XM_RECEIVE_DATA 

 

  3. XAReal

    - 실시간TR을 처리합니다.
    - 수신된 데이터는 다음 데이터가 수신될때까지 유지합니다.
    - Data Type 에 의존하지 않으므로 DLL버전처럼 데이터를 처리하지 않습니다.

[Property]**********************************************************************
ResFileName   RES 파일을 지정 
       
[Method]////////////////////////////////////////////////////////////////////
LoadFromResFile RES 파일을 지정  
True : 성공
False : 실패 
szFileName : Res 파일명   
AdviseRealData TR 등록 
- (반환값 없음)
- (매개변수없음) ETK_AdviseRealData() 
UnadviseRealData   TR 해제 
- (반환값 없음)
- (매개변수없음) ETK_UnadviseRealData() 
GetFieldData   Block 의 Field Data를 취득한다. 
Data 
szBlockName : Block명
szFieldName : Field명   
SetFieldData   Block 의 Field Data를 설정한다. 
- (반환값 없음)
szBlockName : Block명
szFieldName : Field명
szData : Data   
[Event]///////////////////////////////////////////////////////////////////////////
ReceiveRealData 서버로부터 데이터를 수신했을때의 이벤트 
- (반환값 없음)  
- (매개변수없음)

Posted by 스노우볼^^

댓글을 달아 주세요