T4.dll 1.0.13.6 gamma版使用說明與更新記錄

版本別

日期

更新內容

1.0.13.6

(gamma)

2020/10

1. 證券盤中零股參數

1.0.13.6

2020/03

1. 移除國外期貨 ffuture_order, ffuture_cancel, ff_get_response, ff_get_info, ff_get_positions, ff_order_qry (未來將以別的方式支援)

2. 移除國內期貨 舊版 fo_order_qry

3. 移除使用者帳戶 舊版 show_list

4. 新增 parse_response

(取代電文解析附件三)

5. 新增 parse_reply

(取代電文解析附件九)

6. 支援證券逐筆撮合下單 stock_order

7. 支援證券逐筆撮合減量 stock_cancel

8. 支援證券逐筆撮合改價 stock_change

9. Excel 範例移除國外期貨相關功能頁面

10. Excel 範例新增動態模組 cp950.T4functions.bas

11. 版本訊息改用五秒自動回收 msg

1.0.13.5

(beta)

2020/03

1. 移除國外期貨 ffuture_order, ffuture_cancel, ff_get_response, ff_get_info, ff_get_positions, ff_order_qry (未來將以別的方式支援)

2. 移除國內期貨 舊版 fo_order_qry

3. 移除使用者帳戶 舊版 show_list

4. 新增 parse_response

(取代電文解析附件三)

5. 新增 parse_reply

(取代電文解析附件九)

6. 支援證券逐筆撮合下單 stock_order

7. 支援證券逐筆撮合減量 stock_cancel

8. 支援證券逐筆撮合改價 stock_change

9. Excel 範例移除國外期貨相關功能頁面

10. Excel 範例新增動態模組 cp950.T4functions.bas

11. 版本訊息改用五秒自動回收 msg

12. 此為擬真系統專用，無法支援其他系統環境。

1.0.13.4

2015/07

1. future_order 新增支援期貨複式單 (跨月價差)

2. future_order 新增支援 ETF人民幣計價商品

3. 調整回報相容版，小數點下維持3位。 (下一版本將改回報格式、故不相容此版)

4. 調整憑證壓章緩衝，提高主動回報效率。

5. 國內證券未實現損益匯總及明細查詢新增[幣別]及[幣別中文名稱]二欄。

1.0.13.3

2014/12

1. 取消自動啟用主動回報。 (需要主動回報的用戶必須手動啟用)

2. do_register 啟用、停用主動回報

3. stock_balance_detail 證券未實現損益明細 調整結構

1.0.13.2

2014/02/27

1. 新增：證券下單增加「先賣後買」。

1.0.13.1

2014/02/27

1. 新增：證券未實現損益匯總查詢 stock_balance_sum。

2. 新增：證券未實現損益個股明細 stock_balance_detail。

3. 修正：國外期貨商品小數點檢查錯誤導致無法交易玉米粉。

1.0.13.0

2013/10/01

1. 採用新的驗章元件 (支援256bits) 請注意！DLL有增加、減少。

2. 修正非同步驗章 bug

3. 修正回報主動 Event (僅供 C/C++/C# 使用)

1.0.12.9

2012/06/05

1. 增加國外期貨下單回傳格式，附件(十四)

2. 增加多執行緒非同步驗章

3. 增加週選擇權複式單 (Time Spread)

4. 增加主動回報Event 測試版 (僅供 C/C++ 使用)

5. 增加支援 一週期貨 (MX1, MX2, MX4, MX5)

1.0.12.7

2012/07/13

1. 增加 future_change 改價

2. future_cancel 不需帶 oct_type

3. option_cancel 不需帶 oct_type

4. 登入 ID 可以為6-10 碼 (原 8-10)

1.0.12.6

2012/02/16

1. stock_order 參數修改： 定盤、漲跌停，價格參數不被參考，自動修正。

2. 國外期權益數查詢增加「追繳金額」。

3. 修正異常封包可能誤判委託成功。

4. 同時有兩程式作憑證驗章時，會自動重試兩次。(總計三次) 避免短時間鎖住憑證檔案。

5. 多執行緒時，增加同步驗章程序保護措施。 (如果同時呼叫，會自動排隊接續作)

6. 更換前，請務必保留您原始的 t4.ini 設定值。

7. 減少檢查IP 次數。

8. 修正異常封包可能造成連線中斷。

9. 修正 Alive 封包傳送 Interval。

10. 國外期貨委託查詢上限增至 999 筆。

11. 成交回報、委託回報上限至 9000筆。

12. 修正重新連線失敗後，持續重新連線。

13. 修正上午10:05:30 至 10:05:40 期間可能誤判封包造成斷線的問題。

14. Proxy Http Header 增加支援 HTTP/1.0 與 其他相容版本。

15. 新增 fo_order_qry2 可僅查詢 API 紀錄，原 fo_order_qry 仍可繼續使用。

16. 繼4, 請注意：彙總查詢時，無法僅針對 API 來源單作查詢。

17. 文件修正：國外期貨參數應無 octtype 與 ordtype 欄位之說明。

18. 文件修正：期貨、選擇權下單回傳格式如附件(十)。

19. 文件修正：fo_unsettled_qry 對應回傳格式如附件(十一)。

20. 文件修正：ff_get_position 對應回傳格式如附件(十二)。

21. 文件修正：附件(五) 新增兩欄位。

22. 範例修正：國內期權委託查詢可指定是否含預約單。

23. 範例修正：國外期貨部位查詢依照附件(十二)。

24. 修正 41020 的欄位數為27 而不是 25或26

25. 修正 option_order 檢查log 失敗則不繼續執行的奇怪現象

26. 修正 fo_get_day_info 回傳為20000 無此資料時，造成 exception
    修正 fo_get_hist_info 回傳為20000 無此資料時，造成 exception

27. 修改 10.7 的邏輯判斷錯誤，造成長度合法反而一直失敗
    修改 alive 不屬於追蹤封包一者，以免影響回應封包

28. 修改 acc 允許帳號長度為8 ~ 10 碼 (國內法人為8碼)

29. 修改 RecvFromServer thread timeout 為infinite

30. 修改 timer 迴圈, 不再以 Windows Message Procdure 驅動 send_alive, 而以獨立thread 作觸發

31. 修正 log 同步問題, 這是由於之前的版本可能會有 stack overflow 的 issue, 把 log 的 2k 搬到 global 導致

32. 修正 account_list 未重置, 導致 account number 在第二次登入時為0

函式名稱

函式用途簡述

i.

init_t4

初始化 (建立 DLL 環境、連接主機、登入永豐金證券/期貨)

add_acc_ca

帳戶加入憑證清單 (下單之前必須加入)

verify_ca_pass

憑證驗證測試 (必須為已加入憑證清單之帳戶)

ii.

stock_order2

國內證券下單 (證券帳戶必須加入驗證清單)

stock_cancel

國內證券刪單 (證券帳戶必須加入驗證清單)

stock_change

國內證券改價 (證券帳戶必須加入驗證清單)

future_order

國內期貨下單 (期貨帳戶必須加入驗證清單)

future_cancel

國內期貨刪單 (期貨帳戶必須加入驗證清單)

future_change

國內期貨改價 (期貨帳戶必須加入憑證清單)

option_order

國內選擇權下單 (期貨帳戶必須加入驗證清單)

option_cancel

國內選擇權刪單 (期貨帳戶必須加入驗證清單)

iii

get_response

國內下(刪)單回報查詢 (e-Leader 6331)

fo_unsettled_qry

國內期權未平倉查詢 (e-Leader 7201)

fo_order_qry2

期權委託查詢 (e-Leader 6207) 新版

stock_balance_qry

國內證券庫存查詢 (e-Leader 3202)

stock_balance_sum

國內證券未實現損益匯總。 (e-Leader 3324)

stock_balance_detail

國內證券未實現個股明細。 (e-Leader 3325)

fo_get_day_info

國內期權當日權益數查詢 (e-Leader 7102)

fo_get_hist_info

國內期權歷史權益數查詢 (e-Leader 7103)

iv.

get_response_log

交易回報紀錄

check_response_buffer

主動(即時)交易回報-檢查是否已收到回報

timer_response_log

主動(即時)交易回報-讀取回報內容

get_response_evt

取得回報 Event Handle

fifo_response_log

先進先出式交易回報

v.

change_echo

切換下單回覆模式 (下單後是否等待委託回報，預設為「on」)

log_out

登出 init_t4，並清除所有已列之憑證

show_version

回傳目前 API 版本

show_list2

回傳目前使用者下所有帳戶(包含證券、期貨及帳戶別)

show_ip

顯示連線主機 Domain Name

do_register

啟用/停用主動回報

函式名稱：

init_t4

函式功能：

初始化(建立DLL 環境、連接主機、登入永豐金證券/期貨)

VC 宣告：

BSTR init_t4( char* login_id

, char* login_pass

, char* dll_path );

VBA 宣告：

參考cp950.T4functions.bas

C# 宣告：

[DllImport("C:\VBA DLL\t4.dll", SetLastError=true, CharSet=CharSet.Ansi)]
public static extern string init_t4( string login_id, string login_pass, string dll_path );

傳入參數：

login_id : 使用者ID (通常為身份證號，非帳戶)

login_pass : 登入密碼(連線登入密碼，非憑證密碼)

dll_path : DLL 放置路徑(空白或不指定則自動偵測)

使用範例：

ret = init_t4( “A123456789”, “12345678”, “” );

回傳值：

正常：初始化成功(或：已初始化)

異常：會以“Error:” 開頭，接著錯誤訊息。

函式名稱：

add_acc_ca

函式功能：

將證券、憑證帳戶加入憑證清單(下單之前必須加入)

VC 宣告：

BSTR add_acc_ca( char* branch

, char* account

, char* acc_id

, char* ca_path

, ca_password );

VBA 宣告：

參考cp950.T4functions.bas

C# 宣告：

[DllImport("C:\VBA DLL\t4.dll", SetLastError=true, CharSet=CharSet.Ansi)]
public static extern string add_acc_ca( string branch, string account, string acc_id, string acc_ca_path, string acc_ca_pass );

傳入參數：

branch: 分行(期貨以F開頭, 證券僅帶分公司代碼)ps.分公司與帳戶可由show_list取得

account: 帳戶

acc_id: 憑證ID (身份證號)

acc_ca_path: 憑證檔案所在路徑

acc_ca_password: 憑證密碼

使用範例：

期貨：ret = add_acc_ca( "F002000", "9999999", "A123456789", "C:eKey551A123456789S", "12345678" );

證券：ret = add_acc_ca( "9A95", "9999999", "A123456789", "C:ekey551A123456789S", "12345678" );

回傳值：

正常：CA憑證資料登錄成功

異常："Error:"開頭，接著錯誤訊息。

函式名稱：

verify_ca_pass

函式功能：

憑證驗章測試

VC 宣告：

BSTR verify_ca_pass( char*branch, char*account );

VBA 宣告：

參考cp950.T4functions.bas

C# 宣告：

[DllImport("C:\VBA DLL\t4.dll", SetLastError=true, CharSet=CharSet.Ansi)]
public static extern string verify_ca_pass( string branch, string account );

傳入參數：

branch: 分行(期貨以F開頭, 證券以S開頭)

account: 帳戶

使用範例：

ret = verify_ca_pass( "F002000", "9999999" );

回傳值：

正常：""

異常：Error: CA驗證錯誤

函式名稱：

stock_order2

函式功能：

國內證券下單

VC 宣告：

BSTR stock_order2( char*buy_or_sell

, char*branch

, char*account

, char*stock_id

, char*ord_type

, char*price

, char*amount

, char*string

, char*price_type

, ordknd );

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

buy_or_sell: "B"=買, "S"=賣, "F"=先賣

branch: 證券分公司代號

account: 證券帳戶

stock_id: 股票代碼

ord_type: 交易類別

"P0"=定盤現股, "P3"=定盤融資, "P4"=定盤融券

"00"=整股現股, "03"=整股融資, "04"=整股融券

"20"=零股, "C0"="盤中零股"

price: 價格6 位數(定盤、漲跌停時，此參數忽略不作用，會帶0.0)

amount: 張數3 位數(零股則為股數)

price_type: " "=限價, "0"=市價, "2"=漲停價, "3"=跌停價

ordknd: "ROD", "IOC", "FOK"

使用範例：

stock_order2( "B", "5510", "9876543", "2890", "00", "13.00", "1", " ", "ROD" );

回傳值：

異常：TR Error[錯誤編號] = 伺服器錯誤訊息

正常：參考附件(九)

函式名稱：

stock_cancel

函式功能：

國內證券刪單

VC 宣告：

BSTR stock_cancel( char*buy_or_sell

, char*branch

, char*account

, char*stock_id

, char*ord_type

, char*ord_seq

, char*ord_no

, char*pre_order );

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

buy_or_sell : "B" = 買, "S" = 賣

branch : 證券分公司代號

account : 證券帳戶

stock_id: 股票代號

ord_type :

"P0" 定盤現股, "P3" 定盤融資, "P4" 定盤融卷

"00" 整股現股, "03" 整股融資, "04" 整股融卷

"20" 零股, "C0" 盤中零股

ord_seq : 網路單號

ord_no: 委託單號

pre_order : "N" - 非預約單, " " - 預約單

使用範例：

stock_cancel( "B", "5510", "9876543", "2890", "00", "123456", "12345", " " );

回傳值：

異常：TR Error[錯誤編號] = 伺服器錯誤訊息

正常：參考附件(九)

函式名稱：

stock_change

函式功能：

國內證券改價

zVC 宣告：

BSTR stock_change( char*buy_or_sell

, char*branch

, char*account

, char*stock_id

, char*ord_type

, char*ord_seq

, char*ord_no

, char*pre_order

, char*ordknd

, char*price

, char*price_type );

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

buy_or_sell : "B" = 買, "S" = 賣

branch : 證券分公司代號

account : 證券帳戶

stock_id: 股票代號

ord_type :

"P0" 定盤現股, "P3" 定盤融資, "P4" 定盤融卷

"00" 整股現股, "03" 整股融資, "04" 整股融卷

"20" 零股, "C0" 盤中零股

ord_seq : 網路單號

ord_no: 委託單號

pre_order : "N" - 非預約單, " " - 預約單

ordknd: 委託條件ROD, IOC, FOK

price: 新價位

price_type: 市價註記“1”市價, “2”限價(漲跌停價)

使用範例：

回傳值：

異常：TR Error[錯誤編號] = 伺服器錯誤訊息

正常：參考附件(九)

函式名稱：

future_order

函式功能：

國內期貨下單

VC 宣告：

BSTR future_order( char*buy_or_sell

, char*branch

, char*account

, char*future_id

, char*price

, char*amount

, char*price_type

, char*ordtype

, char*octtype );

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

buy_or_sell : "B" = 買, "S" = 賣

branch : 期貨分公司代號

account : 期貨帳戶

future_id : 商品代號

price : 價格6位數

amount : 口數3位數

price type : "MKT"市價, "LMT" 限價

ordtype: ROD / FOK / IOC

octtype: 倉別"0" = 新倉 "1" = 平倉" "= 自動 "6"= 當沖

使用範例：

回傳值：

異常：TR Error[錯誤編號] = 伺服器錯誤訊息

正常：參考附件(十)

函式名稱：

future_cancel

函式功能：

國內期貨刪單

VC 宣告：

BSTR future_cancel( char*branch

, char*account

, char*future_id

, char*ord_seq

, char*ord_no

, char*octtype

, char*pre_order );

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

branch : 期貨分公司代號

account : 期貨帳戶

future_id : 商品代號

ord_seq : 網路單號

ord_no : 委託單號

octtype : "0" 新倉, "1" 平倉, " " 自動"6"= 當沖

pre_order : "N" - 非預約單, " " - 預約單

使用範例：

回傳值：

異常：TR Error[錯誤編號] = 伺服器錯誤訊息

正常：參考附件(十)

函式名稱：

future_change

函式功能：

國內期貨改價

VC 宣告：

BSTR future_change ( char*org_seqno

, char*org_ordno

, char*branch

, char*account

, char*commodity

, char*new_price

, char*pre_order );

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

org_seqno : 原流水書號

org_ordno : 原委託單號

branch : 期貨分公司代號

account : 期貨帳戶

commodity : 期貨商品代號

new_price : 新價格

pre_order : "N" - 非預約單, " " - 預約單

使用範例：

回傳值：

異常：TR Error[錯誤編號] = 伺服器錯誤訊息

正常：參考附件(十)

函式名稱：

option_order

函式功能：

國內選擇權下單

VC 宣告：

BSTR option_order( char*buy_or_sell

, char*branch

, char*account

, char*option_id

, char*price

, char*amount

, char*price_type

, char*ordtype

, char*octtype

, char*isComp

, char*bs3

, char*commodity2 );

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

buy_or_sell : "B" = 買, "S" = 賣

branch : 期貨分公司代號

account : 期貨帳戶

option_id : 選擇權商品代號

price : 價格6位數

amount : 口數3位數

price type : "MKT"市價, "LMT" 限價

ordtype: ROD / FOK / IOC

octtype: 倉別"0" = 新倉 "1" = 平倉" "= 自動 "6"= 當沖

IsComp : "S" 單式, "C" 複式

bs2 : 第二商品買/ 賣(如單式則填”“)

commodity2 : 第二商品代號(如單式則填”“)

使用範例：

回傳值：

異常：TR Error[錯誤編號] = 伺服器錯誤訊息

正常：參考附件(十)

函式名稱：

option_cancel

函式功能：

國內選擇權刪單

VC 宣告：

BSTR option_cancel( char*branch

, char*account

, char*option_id

, char*ord_seq

, char*ord_no

, char*octtype

, char*pre_order );

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

branch : 期貨分公司代號

account : 期貨帳戶

code : 商品代號

ord_seq : 網路單號

ord_num : 委託單號

octtype : "0" 新倉, "1" 平倉, " " 自動

pre_order : "N" - 非預約單, " " - 預約單

使用範例：

回傳值：

異常：TR Error[錯誤編號] = 伺服器錯誤訊息

正常：參考附件(十)

函式名稱：

get_response

函式功能：

國內商品回報查詢

可查詢國內證券、國內期權回報資料(同e-leader 畫面8891)

VC 宣告：

BSTR get_response_log();

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

無

使用範例：

回傳值：

附件(一)

函式名稱：

fo_unsettled_qry

函式功能：

國內期權未平倉查詢(同e-Leader 畫面7201)

VC 宣告：

BSTR fo_unsettled_qry( char*flag

, char*leng

, char*next

, char*prev

, char*gubn

, char*group_name

, char*branch

, char*account

, char*type_1

, char*type_2

, char*time_out );

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

flag = "0000"

leng = "0004"

next = "0000"

prev = "0000"

gubn : 0:單一帳戶1:群組

group name : 群組名稱(單一帳號則填"")

branch : 期貨分公司代號

account : 期貨帳戶

type_1 : 0:所有, 1:期貨, 2:選擇權

type_2 : 0:明細, 1:彙整

time_out = "1"

使用範例：

回傳值：

附件(一)

函式名稱：

fo_order_qry2

函式功能：

期權委託查詢(同e-Leader 畫面6207)

VC 宣告：

BSTR fo_order_qry2( char*branch

, char*account

, char*code

, char*ord_match_flag

, char*ord_type

, char*oct_type

, char*daily

, char*start_date

, char*end_date

, char*preorder

, char*source );

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

branch : 期貨分公司代號

account : 期貨帳戶

code: 商品代號(欲查詢所有商品則填““)

ord_match_flag : 成交類別0:全部明細1:未成交3:委託失敗5:委託彙總

ord_type : 商品類別0:全部商品1:期貨2:選擇權3:美元計價

oct_type: 倉別.定為"0"

daily: 0:當日1:歷史

start_date: 歷史查詢起始日

end_date: 歷史查詢終止日

preorder : ' ' = 含預約單, 'N' = 不含預約單

source : 來源, 1=e-Leader, 2=API, 3=e-Leader + API, 其他數值則傳回全部

使用範例：

回傳值：

函式名稱：

stock_balance_qry

函式功能：

國內證券庫存查詢

VC 宣告：

BSTR stock_balance_qry( char*flag

, char*leng

, char*next

, char*prev

, char*gubn

, char*group_name

, char*branch

, char*account

, char*time_out );

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

flag = "0000"

leng = "0004"

next = "0000"

prev = "0000"

gubn : 0:單一帳戶1:群組

group name : 群組名稱(單一帳戶則填"")

branch : 證券分公司代號

account : 證券帳戶

time_out = "1"

使用範例：

回傳值：

函式名稱：

stock_balance_sum

函式功能：

國內證券未實現損益匯總查詢

VC 宣告：

BSTR stock_balance_qry( char*branch

, char*account

, char*type

, char*action );

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

branch : 證券分公司代號

account : 證券帳戶

ttype : 庫存類別"A" 全部, "0" 現貨, "1" 資, "2" 券

action : 過濾別" " 不濾, "1" 濾下市商品, "2" 不含稅費, "3" 濾下市+不含稅費

使用範例：

stock_balance_sum( "9A95", "9809975", "A", " " )

回傳值：

異常一，API錯誤：API 錯誤訊息

異常二，損益中心錯誤訊息：錯誤代碼,錯誤訊息

正常狀況：附件(十五)

函式名稱：

stock_balance_detail

函式功能：

國內證券未實現損益個股明細

VC 宣告：

BSTR stock_balance_detail ( char*branch

, char*account

, char*stock

, char*ttype );

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

branch : 證券分公司代號

account : 證券帳戶

stock : 股票代碼(例如："2890", 不可帶空白)

ttype : 庫存類別"A" 全部, "0" 現貨, "1" 資, "2" 券

使用範例：

stock_balance_detail( "9A95", "9809975", "2890", "A" );

回傳值：

異常一，API錯誤：API 錯誤訊息

異常二，損益中心錯誤訊息：錯誤代碼,錯誤訊息

正常狀況：附件(十六)

函式名稱：

fo_get_day_info

函式功能：

國內期權當日權益數查詢(同e-Leader 畫面7102)

VC 宣告：

BSTR fo_get_day_info( char*branch, char*account );

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

branch : 期貨分公司代號

account : 期貨帳戶

使用範例：

回傳值：

參考附件(五)

函式名稱：

fo_get_hist_info

函式功能：

國內期權歷史權益數查詢(同e-Leader 畫面7103)

VC 宣告：

BSTR fo_get_hist_info( char*branch

, char*account

, char*sdate

, char*edate );

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

branch : 期貨分公司代號

account : 期貨帳戶

sdate: 開始日期

edate: 結束日期

(僅提供近兩個月資料查詢)

使用範例：

回傳值：

參考附件(六)

函式名稱：

get_response_log

函式功能：

回報紀錄

VC 宣告：

BSTR get_response_log();

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

使用範例：

回傳值：

參考附件(三)

函式名稱：

check_response_buffer

函式功能：

檢查是否有未讀取之主動回報

VC 宣告：

int check_response_buffer();

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

無

使用範例：

回傳值：

1: 有回報尚未讀取, 0: 無新回報

函式名稱：

timer_response_log

函式功能：

讀取尚未讀取之主動回報

VC 宣告：

BSTR timer_response_log();

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

無

使用範例：

回傳值：

參考附件(三)

函式名稱：

fifo_response

函式功能：

先進先出式回報

VC 宣告：

int fifo_response( char*response_str );

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

response_str, 用來接收回傳值。

使用範例：

回傳值：

函式名稱：

get_response_evt

函式功能：

取得Response Event Handle

VC 宣告：

HANDLE get_response_evt();

VBA 宣告：

不支援

傳入參數：

無

使用範例VC：

HANDLE hevtResp = get_response_evt();

DWORD r = WaitForSingleObject( hevtResp, INFINITE );

while( r==WAIT_OBJECT_0 ) {
str = timer_response_log();

// do something
r = WaitForSingleObject( hevtResp, INFINITE );
}

回傳值：

參考MSDN Event Handle

函式名稱：

parse_response

函式功能：

解析主動回報訊息（成回、委回、減量、改價、刪單等回報）

VC 宣告：

int parse_response( BSTR response

, int num

, BSTR*branch

, BSTR*account

, BSTR*ord_no

, BSTR*ord_seq

, BSTR*code

, BSTR*place_price

, BSTR*matched_price

, BSTR*volume

, BSTR*time

, BSTR*status

, BSTR*err

, BSTR*ord_type

, BSTR*place_type

, BSTR*ordknd )

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

response 主動回報訊息(CP950)

num 第幾筆內容(通常1)

branch 取回分公司代號

account 取回帳號

ord_no 取回下單書號

ord_seq 取回網路單號

code 取回商品代碼

place_price 取回委託價

matched_price 取回成交價

volume 取回委託量

time 取回異動時間

status 取回

err 取回伺服器回傳訊息

使用範例VC：

回傳值：

1 成功

函式名稱：

change_echo

函式功能：

切換下單、刪單函式，是否等待委託狀態，才返回函式。(預設：等待)

(非等待模式可較快返回函式，但必須由主動回報處判斷委託狀態)

(對於每秒超過6筆以上的用戶，可於較短的反應時間內連續下單)

VC 宣告：

BSTR change_echo();

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

使用範例：

回傳值：

函式名稱：

log_out

函式功能：

結束、登出。

(所有之前加入的憑證清單會一併清除)

VC 宣告：

int log_out();

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

無

使用範例：

回傳值：

0: 成功登出, -1: 登出失敗、或其他錯誤

函式名稱：

show_version

函式功能：

回傳目前API 版本

VC 宣告：

BSTR show_version();

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

無

使用範例：

回傳值：

函式名稱：

show_list

函式功能：

回傳目前登入ID 所擁有之所有帳戶

VC 宣告：

BSTR show_list();

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

無

使用範例：

回傳值：

函式名稱：

show_ip

函式功能：

回傳目前連線之伺服器domain

VC 宣告：

BSTR show_ip();

VBA 宣告：

參考cp950.T4functions.bas

傳入參數：

無

使用範例：

回傳值：

sinotrade.com.tw

函式名稱：

do_register

函式功能：

停用、啟用主動回報

VC 宣告：

int do_register( int YorN );

VBA 宣告：

參考cp950.T4functions.bas

VC# 宣告：

[DllImport("C:\VBA DLL\t4.dll", SetLastError=true, CharSet=CharSet.Ansi)]
public static extern int do_register( int YorN );

傳入參數：

0 : 停用主動回報

1 : 啟用主動回報

使用範例：

回傳值：

0 : 成功

-1 : 失敗

錯誤訊息：

可能原因：

尚未初始化, 請先初始化

未正確執行 init_t4

註冊程序錯誤

無法登錄該帳戶

socket error

作業系統無法提供網路

參數長度錯誤

傳入的參數長度不正確

invalid message handle

與伺服器之間的同步發生異常，請登出重新登入。

張數需大於 0

指定的張數/股數不得小於等於零。

價格需大於 0

指定的價位不得小於或等於零。

指定使用漲/跌停價時 價格欄位必須為 0

輸入值超出範圍

商品價格輸入錯誤, 請重新確認

輸入值超出範圍

價格需為該商品價最小跳動點之倍數

輸入值超出範圍

價格分母輸入錯誤

輸入值超出範圍

價格錯誤,請確認價格格式後再行輸入

輸入格式錯誤

短時間內查詢次數過多，請稍後嘗試...

未平倉查詢次數已屆伺服器安全容許值

參數輸入錯誤 (查詢日期期間需以 YYYYMMDD ~ YYYYMMDD 代表)

日期格式錯誤

daily (僅查詢當日)參數錯誤

輸入值超出範圍

下單確認回應(Echo)設定錯誤

輸入值超出範圍

僅提供近兩個月資料查詢

輸入值超出範圍

商品名稱錯誤

商品名稱錯誤

複式商品名稱錯誤

複式商品名稱錯誤

分公司/客戶帳戶 錯誤

證券或期貨帳戶錯誤，或是分公司錯誤

gnbu 參數無效

該函式不支援群組功能，或指定值超出範圍

本功能暫不提供群組查詢

暫不支援

伺服器回傳資料長度有誤，請確認版本相容性

請更新為最新版本

socket send error, 送單失敗

網路傳輸失敗，系統網路可能異常。

TR Error

伺服器回應錯誤 (非API元件或使用錯誤)

CA憑證資料登錄失敗 [ CA身份證不符 ]

憑證所屬人身份證號與add_acc_ca輸入不符。

無法建立操作紀錄，取消。

無法產生 log 檔，所有 log 將會被放棄。

Server連接設定錯誤, 請確認t4.ini的參數

無法從 t4.ini 讀取正確伺服器位址、連接埠。

版本無效，請使用目前發行版本。

請更新最新發行中 API 元件。

無法登入

網路異常，請重新嘗試登入。

登入密碼錯誤!

登入使用者之密碼錯誤 (非憑證密碼)

無此帳號!

登入使用者之 ID 錯誤 (通常為身份證字號)

下單帳號取得失敗

登入之使用者可能無有效之證券、期貨帳戶

市價單&複式選擇權單無法選取<當日有效委託>(ROD)

輸入值超出範圍

委託內容錯誤, 無此組合

選擇權下單組合錯誤

您的帳號目前無法使用VBA功能，請洽營業同仁，提出申請。

根據『期貨經紀商提供API服務之相關控管措施』：期貨交易人應親持身份證件提出書面申請並於營業場所當場簽名或蓋章。

Header

Record 1

Record 2

…

Record N

欄位

說明

長度

count

筆數

5

字元數：

5

欄位

說明

長度

Type

Type:

STOCK:93

FUTURE:91

2

CancelQty

刪單量

6

ContractQty

成交量

6

OrgPrice

原委託價格

10

padding

保留未用

2

回報子格式(參考附件三)

219

字元數：

235

Header

Record 1

欄位

說明

長度

type

類別

2

count

筆數

2

字元數：

4

欄位

說明

長度

回報子格式(參考附件三)

219

字元數：

219

Seqnence

序號

8

Branch

分公司代碼

8

Account

帳戶

7

Order No

委託書號(預約單無此值)

5

Order Senq

網路單號

6

Code

商品代碼

10

Trade_type

Stock:01:買/02:賣/03:改量/04:刪單
future:1:買/2:賣/ CXL:刪單/UPD:減量/UPL:改限價/UPM:改市價

3

Trade_class

01:現賣/ 02:現買/ 03:資賣/04:資買/ 05:券賣/ 06:券賣

B:買/ S:賣

2

Placing Price

委託價

10

Matched Price

成交價

10

Ordknd

證券期權：ROD/FOK/IOC

3

Qty

數量(委託量/刪單量)

6

Trans_time