ZSMQ系列文檔――API編程手冊 For C++
C++ API編程手冊
(C++語言)
－－ ZSMQ系列文檔 －－
ZSMQ系列文檔――API編程手冊 For C++
目 錄
一章 ZSMQ API FOR C++ 概述
1.1. ZSMQ API FOR C++ 編譯器
1.2. ZSMQ API FOR C++ 編程步驟
二章ZSMQ API FOR C++ 函數參考
2.1. CONNECTZSMQ（連接交換管理平臺）
2.2. DISCONNECTZSMQ（斷開與交換管理平臺的連接）
2.3. ZSMQGETLASTERROR（取得錯誤描述信息）.
2.4. ZSMQGETERRORTYPECODE（取得錯誤類型碼）
2.5. ZSMQGETERRORREASONCODE（取得錯誤原因代碼）
2.6. COMMIT（提交操作）.
2.7. ROLLBACK（回滾操作）
2.8. DTCOMMIT（二次提交）
2.9. SENDBUFFER（發送內存緩沖）.
2.10. SENDFILE（發送文件）
2.11. GETFILE（收取文件）.
2.12. CREATEMESSAGE（建立消息）
2.13. GETMESSAGEINTERFACE（取得消息）.
2.14. DESTORYMESSAGEINTERFACE （銷毀消息接口）
2.15. DELETEMESSAGE（刪除消息）
2.16. LOCKQUEUE（鎖隊列）..
2.17. UNLOCKQUEUE（解鎖隊列）
2.18. GETQUEUECOUNT（取得隊列數量）
2.19. GETQUEUENAME（取得隊列的名稱）.
2.20. GETQUEUEDATATYPECOUNT（取得隊列中數據類型的數量）
2.21. GETQUEUEDATATYPENAME（取得數據類型的名稱）.
2.22. GETQUEUEDEPTH（取得隊列的深度）
2.23. GETMESSAGELENGTH（取得消息長度）
2.24. GETREMAINMESSAGELENGTH（取得剩余消息長度）.
2.25. GETDATAFROMMESSAGE（從消息中取得數據） 20
2.26. WRITEDATAFROMMESSAGE（在消息中寫入數據）..
2.27. SEEKMESSAGE（在消息中移動指針）.
三章ZSMQ API FOR C++ 例子程序.
3.1. SENDTEST（文件發送
3.2. RCVTEST（接收文件）.
3.3. DELETETEST（刪除消息）
3.4. BROWSETEST（瀏覽隊列）
附錄：ZSMQ 代碼信息參考
4.1. 錯誤類型參考
4.2. 錯誤原因參考
ZSMQ系列文檔――API編程手冊 For C++
一章 ZSMQ API FOR C++ 概述
1.1. ZSMQ API FOR C++ 編譯器
ZSMQ API FOR C++ 支持VC60、VC7.0、VC7.1、G++ 等常用的C++編譯器，
通過加載動態庫的方式可以支持任意C++編譯器如Xlc、Borland C++等。
1.2. ZSMQ API FOR C++ 編程步驟
1. 包含頭文件#include “ZSMQapi.h”
2. 調用函數ConnectZSMQ 得到數據交換管理平臺接口IZSMQInterface
3. 使用接口IZSMQInterface 提供的方法進行操作，如發送文件、接收文件、
提交操作、回滾操作等。當調用的方法返回失敗的時候，可以調用
ZSMQGetLastError 函數查看錯誤信息、調用ZSMQGetErrorTypeCode
函數查看錯誤類型、調用ZSMQGetErrorReasonCode函數查看錯誤原
因代碼。
4. 最后調用DisConnectZSMQ 關閉與數據交換管理平臺之間的連接通道，
并釋放相關資源。
ZSMQ系列文檔――API編程手冊 For C++
二章ZSMQ API FOR C++ 函數參考
2.1. ConnectZSMQ（連接交換管理平臺）
函數說明：ConnectZSMQ() 用來連接交換管理平臺，在客戶端與服務器之間建立
連接通道，如果成功返回IZSMQInterface 接口，以后對平臺的所有操作均通過
IZSMQInterface接口完成；如果失敗函數返回NULL,可以調用ZSMQGetLastError
查看錯誤信息、調用ZSMQGetErrorTypeCode 查看錯誤類型、調用
ZSMQGetErrorReasonCode查看錯誤原因代碼。
輸入參數：const char* szQueueManagerName 隊列管理器名稱
unsigned short usListenerPort 隊列服務監聽端口
輸出參數：函數本身輸出IZSMQInterface接口
備注信息：szQueueManagerName 輸入NULL 表示連接缺省隊列管理器，
usListenerPort輸入0表示連接默認的監聽端口
例子程序：
IZSMQInterface* pZSMQI = ConnectZSMQ(szQMName);
if (!pZSMQI)
{
printf("連接ZSMQ失敗{錯誤描述%s} ",ZSMQGetLastError());
printf("錯誤類型碼[%d] 錯誤碼
[%d] ",ZSMQGetErrorTypeCode(),ZSMQGetErrorReasonCode());
return -1;
}
else
{
printf(“連接ZSMQ成功 ”);
}
DisConnectZSMQ(pZSMQI);//斷開連接、釋放內存
2.2. DisConnectZSMQ（斷開與交換管理平臺的連接）
函數說明：DisConnectZSMQ() 用來斷開與交換管理平臺之間的連接，并釋放所
有申請的內存。
輸入參數：pZSMQInterface IZSMQInterface接口
輸出參數：無
備注信息：無
例子程序： 參考2.1的例子程序
ZSMQ系列文檔――API編程手冊 For C++
2.3. ZSMQGetLastError（取得錯誤描述信息）
函數說明：ZSMQGetLastError() 用來取得錯誤的描述信息，當調用API中任意一
個函數失敗后，均可以通過這個函數取得錯誤的描述信息。
輸入參數：無
輸出參數：函數本身返回const char* 指向錯誤的描述信息
備注信息：無
例子程序： 參考2.2.1的例子程序
2.4. ZSMQGetErrorTypeCode（取得錯誤類型碼）
函數說明：ZSMQGetErrorTypeCode() 用來取得錯誤的類型碼，當調用API中任
意一個函數失敗后，均可以通過這個函數取得錯誤的類型碼，來確定下一步應用
程序如何進行處理。
輸入參數：無
輸出參數：函數本身返回const long 為錯誤類型碼
備注信息：錯誤類型碼 0 表示沒有錯誤
錯誤類型碼10000表示函數調用的時候輸入的參數出現錯誤
錯誤類型碼20000表示服務器返回錯誤，需查看錯誤原因碼
錯誤類型碼40000表示磁盤IO方面出現錯誤
錯誤類型碼80000表示與服務器連接方面出現錯誤
例子程序： 參考2.1的例子程序
2.5. ZSMQGetErrorReasonCode（取得錯誤原因代碼）
函數說明：ZSMQGetErrorReasonCode() 用來取得錯誤的原因代碼，當調用API
中任意一個函數失敗后，均可以通過這個函數取得錯誤的原因代碼。
輸入參數：無
輸出參數：函數本身返回const long 為錯誤原因代碼
備注信息：請參考本文檔中ZSMQ代碼信息參考章節獲得詳細的信息
例子程序： 參考2.1的例子程序
ZSMQ系列文檔――API編程手冊 For C++
5
2.6. Commit（提交操作）
函數說明：Commit() 用來提交操作，當進行消息操作（取出、建立）時，需要
要進行提交才能真正的生效。成功返回true，如果失敗函數返回false,可以調用
ZSMQGetLastError查看錯誤信息、調用ZSMQGetErrorTypeCode查看錯誤類型、
調用ZSMQGetErrorReasonCode查看錯誤原因代碼。
輸入參數：無
輸出參數：函數本身返回函數的執行結果
備注信息：支持無限級提交
例子程序： 無
2.7. Rollback（回滾操作）
函數說明：Rollback() 用來回滾操作，當進行消息操作（取出、建立）時，為了
保證事務的一致性可以通過回滾來撤銷之前的所有操作。成功返回true，如果失
敗函數返回false,可以調用ZSMQGetLastError 查看錯誤信息、調用
ZSMQGetErrorTypeCode 查看錯誤類型、調用ZSMQGetErrorReasonCode 查看
錯誤原因代碼。
輸入參數：無
輸出參數：函數本身返回函數的執行結果
備注信息：支持無限級回滾，注意當客戶端斷開與服務器的連接時，所有未提交
的操作會被自動回滾。
例子程序： 無
2.8. DTCommit（二次提交）
函數說明：DTCommit() 用來提交操作，DTCommit與Commit的功能相同，當
進行消息操作（取出、建立）時，需要要進行提交才能真正的生效。DTCommit
支持二次提交操作，應用程序將提交的回調函數傳入DTCommit，DTCommit
在內部調用回調函數進行應用層的提交，并保證兩個事務的一致性。成功返回
true，如果失敗函數返回false,可以調用ZSMQGetLastError查看錯誤信息、調用
ZSMQGetErrorTypeCode 查看錯誤類型、調用ZSMQGetErrorReasonCode 查看
錯誤原因代碼。
輸入參數：int(*)()
輸出參數：函數本身返回函數的執行結果
備注信息：支持無限級提交
例子程序： 無
ZSMQ系列文檔――API編程手冊 For C++
6
2.9. SendBuffer（發送內存緩沖）
函數說明：SendBuffer() 通過IZSMQInterface接口進行調用，作用是向交換管理
平臺發送一段緩沖，成功返回true，如果失敗函數返回false,可以調用
ZSMQGetLastError查看錯誤信息、調用ZSMQGetErrorTypeCode查看錯誤類型、
調用ZSMQGetErrorReasonCode查看錯誤原因代碼。
輸入參數：szTargetID 目的地地址
usTargetIDCount 目的地地址個數
szTargetQueueName 目的地接收隊列名稱
szDataType 數據類型
cPriority 優先級別 0 ~ 9
cEncrypt 加密算法 0 為沒有加密 保留字段
cCompress 壓縮算法 0 為沒有壓縮 保留字段
cSendType 發送類型 0 保留字段
cReply 是否回執 保留字段
ulTimeOut 超時時間 0 為69久久久久精品9999不卡片,夜精品A片一区二区三区无码白浆,坐公交车弄了2个小时,成人乱人乱一区二区三区
亚洲AV无码精品色午夜蜜桃|
精品国产乱码久久久久久小说|
亚洲午夜性春猛交XXXX|
日本肉体裸交XXXXBBBB|
√天堂中文官网在线|
久久久精品|
人妻少妇看A片偷人精品视频|
一本色道久久综合亚洲AV蜜桃|
你弄得人家里都是水的视频|
囯产精品久久久久久久久免费蜜桃|
