養(yǎng)老保險(xiǎn)待遇狀態(tài)比對查詢服務(wù)系統(tǒng)接口開發(fā)手冊

1、養(yǎng)老保險(xiǎn)待遇狀態(tài)比對查詢服務(wù)系統(tǒng)接口開發(fā)手冊（1.0版）2011.7.25目 錄1接口api使用說明11.1接口api概述12java接口使用說明12.1java接口類列表12.2java接口api說明22.2.1上傳fileuploadagentfileuploadparamsfileuploadresponse62.2.2通用查詢commqueryagentcommqueryresponse92.2.3錯(cuò)誤文件下載errfiledownloadagenterrfiledown

2、loadparamserrfiledownloadresponse142.2.4證書有效期查詢certqueryagent162.3java接口開發(fā)舉例162.3.1領(lǐng)取人員批量查詢領(lǐng)取人員批量查詢上傳通用查詢（查詢領(lǐng)取待遇人員批量查詢結(jié)果）錯(cuò)誤文件列表查詢錯(cuò)誤文件下載183c接口使用說明193.1c接口api說明193.1.1上傳fileuploadagentinitsetfileuploadparamsfileuploadsend

3、andreceivegetfileuploadresponsefileuploadagentend213.1.2通用查詢commqueryagentinitsetcommqueryparamscommquerysendandreceivegetcommqueryresponsecommqueryagentend233.1.3錯(cuò)誤文件下載errfiledownloadagentinitseterrfiledownloadparams23

4、errfiledownloadsendandreceivegeterrfiledownloadresponseerrfiledownloadagentend253.1.4證書有效期查詢getcertperiod25附錄1比對查詢系統(tǒng)反饋的錯(cuò)誤代碼列表1附錄2：接口反饋代碼2附錄3：查詢條件列表6附錄4：開發(fā)常見問題及解答881 接口api使用說明1.1 接口api概述在采用嵌入式或前置系統(tǒng)接入模式下，基于本手冊進(jìn)行本地后臺接口的開發(fā)。比對查詢業(yè)務(wù)接口api提供了基于java和c語言的兩種接口封裝形式，各地可根據(jù)本地業(yè)務(wù)管理系統(tǒng)

5、的開發(fā)環(huán)境選用。java接口采用jar包形式，c語言采用動態(tài)鏈接庫dll形式并提供開發(fā)需要的.h頭文件和.lib庫文件。在實(shí)際的運(yùn)行環(huán)境中，需要將jar或者dll文件部署到使用比對查詢業(yè)務(wù)接口的系統(tǒng)庫文件目錄內(nèi)，部署接口api的服務(wù)器必須能夠通過網(wǎng)絡(luò)直接訪問部級養(yǎng)老保險(xiǎn)待遇狀態(tài)比對查詢服務(wù)系統(tǒng)進(jìn)行數(shù)據(jù)交換，同時(shí)由于接口會自動對傳輸?shù)臄?shù)據(jù)進(jìn)行數(shù)字簽名，需要在此服務(wù)器上部署安裝金保工程統(tǒng)一的設(shè)備數(shù)字證書以及相關(guān)認(rèn)證軟件包。2 java接口使用說明2.1 java接口類列表接口名稱接口描述fileuploadagent文件上傳代理fileuploadparams上傳文件參數(shù)對象fileuploadr

6、esponse上傳文件結(jié)果返回對象commqueryagent通用查詢代理commqueryresponse通用查詢返回對象errfiledownloadagent下載錯(cuò)誤文件代理errfiledownloadparams下載錯(cuò)誤文件參數(shù)對象errfiledownloadresponse下載錯(cuò)誤結(jié)果返回對象certqueryagent查詢證書有效期對象2.2 java接口api說明jar包名稱：sitrb.jar依賴包：axis 1.4開發(fā)環(huán)境要求：支持eclipse等各類java開發(fā)工具，j2se1.4及以上版本。運(yùn)行環(huán)境要求：jre1.4以及上版本，可以部署在j2ee容器內(nèi)運(yùn)行。2.2.1

7、 上傳 fileuploadagent上傳文件代理類，上傳文件時(shí)調(diào)用此類。構(gòu)造方法摘要fileuploadagent()初始化一個(gè)建新的fileuploadagent對象。方法摘要fileuploadresponse sendandreceive(fileuploadparams upparams)將請求信息發(fā)送給服務(wù)器,并返回一個(gè)fileuploadresponse對象。構(gòu)造方法詳細(xì)信息.1 fileuploadagentpublic fileuploadagnet()初始化一個(gè)新建的fileuploadagent對象。方法詳細(xì)信息.2 sendan

8、dreceivepublic fileuploadresponse sendandreceive(fileuploadparams upparams)將請求信息發(fā)送給服務(wù)器,并返回一個(gè)fileuploadresponse對象。參數(shù)：upparams 上傳文件參數(shù)對象。返回：fileuploadresponse 上傳文件結(jié)果返回對象。 fileuploadparams上傳文件參數(shù)類，用于傳入上傳文件請求的各種參數(shù)。構(gòu)造方法摘要fileuploadparams()初始化一個(gè)建新的fileuploadparams對象。方法摘要void setorgid(string orgid)傳入組

9、織機(jī)構(gòu)代碼void setbuzztype(string transtype)傳入業(yè)務(wù)數(shù)據(jù)分類標(biāo)識void setsendtype(string uptype)傳入上傳方式，1-以文件方式上傳；2-以流方式上傳void setuploadfilename (string uploadfilename)傳入上傳文件的文件名。void setuploadstream(string stream)傳入待上傳字符流。以文件方式上傳時(shí)不需傳入該值。void setcerttype (string certtype)傳入證書類型。public void setxzscope(string xzscope)

10、上傳文件所屬險(xiǎn)種，必須是具體一個(gè)險(xiǎn)種類型，如110、120、150。構(gòu)造方法詳細(xì)信息.1 fileuploadparamspublic fileuploadparams()初始化一個(gè)新建的fileuploadparams對象。方法詳細(xì)信息.2 setbuzztypepublic void setbuzztype(string buzztype)傳入本次上傳的交易類型。參數(shù)：buzztype 本次上傳的業(yè)務(wù)類型代碼。返回：無。.3 setdatafiletypepublic void setdatafiletype(string datafiletype

11、)傳入數(shù)據(jù)文件類型。參數(shù)：datafiletype 數(shù)據(jù)文件類型。1txt文件。返回：無。.4 setsendtypepublic void setsendtype(string sendtype)傳入上傳方式。參數(shù)：sendtype 上傳方式，1- 以文件方式上傳。2- 以流方式上傳。返回：無。.5 setfiledatepublic void setfiledate(string senddate)傳入文件生成日期。參數(shù)：filedate 文件生成日期，格式為yyyymmdd。返回：無。.6 setuploadfilenamepublic void

12、 setuploadfilename(string uploadfilename)傳入上傳文件的文件名。參數(shù)：uploadfilename 文件名。返回：無。.7 setuploadstreampublic void setuploadstream(string stream)傳入待上傳字符流。參數(shù)：stream 待上傳字符流，當(dāng)上傳方式為文件方式時(shí)返回值無意義。返回：無。.8 setcerttypepublic void setcerttype(string certtype)傳入證書類型。參數(shù)：certtype 證書類型。2設(shè)備證書。返回：無。.9

13、 setxzscopepublic void setxzscope(string xzscope)傳入險(xiǎn)種類型。參數(shù)：xzscope ,險(xiǎn)種類型：110城鎮(zhèn)企業(yè)職工基本養(yǎng)老保險(xiǎn)，120機(jī)關(guān)事業(yè)單位養(yǎng)老保險(xiǎn)，150新型農(nóng)村社會養(yǎng)老保險(xiǎn)，160城鎮(zhèn)居民社會養(yǎng)老保險(xiǎn)，170城鄉(xiāng)居民社會養(yǎng)老保險(xiǎn)。返回：無。 fileuploadresponse上傳結(jié)果返回對象，返回上傳文件處理是否成功標(biāo)志及處理信息。構(gòu)造方法摘要fileuploadresponse()初始化一個(gè)建新的fileuploadresponse對象。方法摘要string geterrorflag()獲取上傳文件處理是否成功標(biāo)志。

14、string getretmsg()獲取上傳文件處理結(jié)果信息。string getstackstrace()獲取查詢操作的錯(cuò)誤堆棧構(gòu)造方法詳細(xì)信息.1 fileuploadresponsepublic fileuploadresponse()初始化一個(gè)新建的fileuploadresponse對象。方法詳細(xì)信息.2 geterrorflagpublic string geterrorflag()獲取上傳文件處理是否成功標(biāo)志。參數(shù)：無。返回：string 是否成功標(biāo)志。0成功，非0失?。ň唧w類型參見錯(cuò)誤類型列表）.3 getretmsgpublic st

15、ring getretmsg()獲取上傳文件處理結(jié)果信息。參數(shù)：無。返回：string 上傳文件處理結(jié)果信息。.4 getstacktracepublic string getstacktrace()獲取上傳操作的錯(cuò)誤堆棧。參數(shù)：無。返回：string 上傳操作的錯(cuò)誤堆棧。2.2.2 通用查詢 commqueryagent通用查詢代理類，向后臺發(fā)送各類業(yè)務(wù)查詢請求，后臺業(yè)務(wù)程序按約定格式返回查詢結(jié)果。構(gòu)造方法摘要commqueryagent()初始化一個(gè)建新的commqueryagent對象。方法摘要void setorgid(string orgid)傳入組織機(jī)構(gòu)

16、代碼string setcerttype (string certtype)傳入證書類型。void setbuzztype(string funcid)傳入查詢請求業(yè)務(wù)類型。void setqueryparams(hashmap params)傳入查詢請求參數(shù)。不同的業(yè)務(wù)查詢所需要的參數(shù)不盡相同，具體業(yè)務(wù)查詢參數(shù)詳見接口功能說明部分。string query()將請求信息發(fā)送給服務(wù)器，查詢業(yè)務(wù)數(shù)據(jù)，業(yè)務(wù)程序按約定格式返回結(jié)果字符串，具體格式參見數(shù)據(jù)傳輸封裝規(guī)范。public void setxzscope(string xzscope)查詢所屬險(xiǎn)種，具體一個(gè)險(xiǎn)種類型，如110、120、150。

17、對應(yīng)上傳文件的險(xiǎn)種類型。構(gòu)造方法詳細(xì)信息.1 commqueryagentpublic commqueryagent ()初始化一個(gè)新建的commqueryagent對象。方法詳細(xì)信息.2 setbuzztypepublic void setbuzztype (string buzztype)傳入查詢業(yè)務(wù)類型，具體類型對應(yīng)業(yè)務(wù)詳見接口功能列表。參數(shù)：buzztype 查詢請求業(yè)務(wù)類型返回：無。.3 setdatafiletypepublic void setdatafiletype(string datafiletype)傳入數(shù)據(jù)文件類型。參數(shù)：dat

18、afiletype 數(shù)據(jù)文件類型。1txt文件。返回：無。.4 setcerttypepublic void setcerttype(string certtype)傳入證書類型。參數(shù)：certtype 證書類型?！?” 設(shè)備證書返回：無。.5 setqueryparampublic void setqueryparam(hashmap params)傳入查詢參數(shù)。參數(shù)：params 查詢參數(shù)，不同的查詢業(yè)務(wù)所需要的參數(shù)不盡相同，全部為string類型，具體參數(shù)詳見接口功能列表。返回：無。.6 querypublic commqueryresponse

19、 query()將查詢請求發(fā)送到服務(wù)器，查詢業(yè)務(wù)數(shù)據(jù)，業(yè)務(wù)程序按約定格式返回結(jié)果字符串，具體格式參見數(shù)據(jù)傳輸封裝模范。參數(shù)：無返回：commqueryresponse 返回的查詢數(shù)據(jù)。.7 setxzscopepublic void setxzscope(string xzscope)傳入險(xiǎn)種類型。參數(shù)：xzscope ,險(xiǎn)種類型：110城鎮(zhèn)企業(yè)職工基本養(yǎng)老保險(xiǎn)，120機(jī)關(guān)事業(yè)單位養(yǎng)老保險(xiǎn)，150新型農(nóng)村社會養(yǎng)老保險(xiǎn)，160城鎮(zhèn)居民社會養(yǎng)老保險(xiǎn)，170城鄉(xiāng)居民社會養(yǎng)老保險(xiǎn)。返回：無。 commqueryresponse查詢結(jié)果返回對象，返回下載文件處理是否成功標(biāo)志,

20、查詢得到的信息和文件名。構(gòu)造方法摘要commqueryresponse()初始化一個(gè)建新的filedownloadresponse對象。方法摘要string geterrorflag()獲取查詢是否成功標(biāo)志。string getretmsg()獲取查詢結(jié)果信息。string getstackstrace()獲取查詢操作的錯(cuò)誤堆棧string getdownfilename()獲取查詢結(jié)果的文件名稱。string getdownstream()獲取查詢結(jié)果。構(gòu)造方法詳細(xì)信息.1 commqueryresponsepublic filedownloadresponse()初始化一個(gè)新

21、建的filedownloadresponse對象。方法詳細(xì)信息.2 geterrorflagpublic string geterrorflag()獲取下載文件處理是否成功標(biāo)志。參數(shù)：無。返回：string 是否成功標(biāo)志。0成功，非0失?。ň唧w類型參見錯(cuò)誤類型列表）.3 getretmsgpublic string getretmsg()獲取下載文件處理結(jié)果信息。參數(shù)：無。返回：string 下載文件處理結(jié)果信息。.4 getdownfilenamepublic string getdownfilename()獲取下載后的文件名稱。參數(shù)：無。返回：st

22、ring 下載后的文件名稱。.5 getstacktracepublic string getstacktrace()獲取上傳文件處理結(jié)果信息。參數(shù)：無。返回：string 上傳操作的錯(cuò)誤堆棧。.6 getdownstreampublic string getdownstream()獲取下載的字符流。參數(shù)：無。返回：string 下載的字符流。2.2.3 錯(cuò)誤文件下載 errfiledownloadagent錯(cuò)誤文件下載代理類，下載錯(cuò)誤文件時(shí)調(diào)用此類。構(gòu)造方法摘要errorfiledownloadagent()初始化一個(gè)建新的errorfiledown

23、loadagent對象。方法摘要filedownloadresponse sendanddownloaderrfile(errfiledownloadparams errdownparams)將下載錯(cuò)誤文件的請求參數(shù)發(fā)送給服務(wù)器，下載錯(cuò)誤文件，并返回一個(gè)filedownloadresponse對象。public void setxzscope(string xzscope)下載文件所屬險(xiǎn)種，是具體一個(gè)險(xiǎn)種類型，如110、120、150。對應(yīng)上傳文件的險(xiǎn)種類型。構(gòu)造方法詳細(xì)信息.1 errfiledownloadagentpublic filedownloadagnet()初始化一

24、個(gè)新建的filedownloadagent對象。方法詳細(xì)信息.2 sendanddownloaderrfilepublic filedownloadresponse sendanddownloaderrfile(errfiledownloadparams errdownparams)將請求信息發(fā)送給服務(wù)器，下載錯(cuò)誤文件，并返回一個(gè)filedownloadresponse對象。參數(shù)：errdownparams 下載錯(cuò)誤文件參數(shù)對象。返回：filedownloadresponse 下載文件結(jié)果返回對象。 errfiledownloadparams下載錯(cuò)誤文件參數(shù)類，用于

25、傳入下載錯(cuò)誤文件的各種參數(shù)。構(gòu)造方法摘要errfiledownloadparams()初始化一個(gè)建新的errfiledownloadparams對象。方法摘要void setorgid(string orgid)傳入組織機(jī)構(gòu)代碼string setdatafiletype (string datafiletype)傳入數(shù)據(jù)文件類型。string setorignalfilename (string orignalfilename)傳入上傳原文件名。string setcerttype (string certtype)傳入證書類型。public void setxzscope(string x

26、zscope)下載文件所屬險(xiǎn)種，是具體一個(gè)險(xiǎn)種類型，如110、120、150。對應(yīng)上傳文件的險(xiǎn)種類型。構(gòu)造方法詳細(xì)信息方法詳細(xì)信息.1 setcerttypepublic void setcerttype(string certtype)傳入證書類型。參數(shù)：certtype 證書類型。”2” 設(shè)備證書返回：無。.2 setdatafiletypepublic void setdatafiletype(string datafiletype)傳入數(shù)據(jù)文件類型。參數(shù)：datafiletype 數(shù)據(jù)文件類型。1txt文件。返回：無。.3 setorignal

27、filenamepublic void setorignalfilename(string orignalfilename)傳入證書類型。參數(shù)：orignalfilename 待下載的錯(cuò)誤文件名。返回：無。.4 setxzscopepublic void setxzscope(string xzscope)傳入險(xiǎn)種類型。參數(shù)：xzscope ,險(xiǎn)種類型：110城鎮(zhèn)企業(yè)職工基本養(yǎng)老保險(xiǎn)，120機(jī)關(guān)事業(yè)單位養(yǎng)老保險(xiǎn)，150新型農(nóng)村社會養(yǎng)老保險(xiǎn)，160城鎮(zhèn)居民社會養(yǎng)老保險(xiǎn)，170城鄉(xiāng)居民社會養(yǎng)老保險(xiǎn)。返回：無。 errfiledownloadresponse下載文件結(jié)果返

28、回對象，返回下載文件處理是否成功標(biāo)志、處理信息和下載后的文件名。構(gòu)造方法摘要errfiledownloadresponse()初始化一個(gè)建新的filedownloadresponse對象。方法摘要string geterrorflag()獲取上傳文件處理是否成功標(biāo)志。string getretmsg()獲取上傳文件處理結(jié)果信息。string getdownfilename()獲取下載后的文件名稱。當(dāng)下載數(shù)據(jù)文件類型為2-字符流時(shí)，文件名無意義。string getdownstream()獲取下載后的字符流。構(gòu)造方法詳細(xì)信息.1 errfiledownloadresponsepub

29、lic filedownloadresponse()初始化一個(gè)新建的filedownloadresponse對象。方法詳細(xì)信息.2 geterrorflagpublic string geterrorflag()獲取下載文件處理是否成功標(biāo)志。參數(shù)：無。返回：string 是否成功標(biāo)志。0成功，非0失?。ň唧w類型參見錯(cuò)誤類型列表）public string getretmsg()獲取下載文件處理結(jié)果信息。參數(shù)：無。返回：string 下載文件處理結(jié)果信息。.3 getstacktracepublic string getstacktrace()獲取上傳文件處理結(jié)果信息

30、。參數(shù)：無。返回：string 上傳操作的錯(cuò)誤堆棧。.4 getdownfilenamepublic string getdownfilename()獲取下載后的文件名稱。參數(shù)：無。返回：string 下載后的文件名稱。.5 getdownstreampublic string getdownstream()獲取下載的字符流。參數(shù)：無。返回：string 下載的字符流。2.2.4 證書有效期查詢 certqueryagent方法詳細(xì)信息public static string getcertperiod()獲取證書的有效期參數(shù)：無返回：無異常直接返回

31、有效期 格式為yyyy年mm月dd日 如：2018年01月12日 異常返回 獲取本地證書有效期失敗+exception2.3 java接口開發(fā)舉例java接口與界面方式一樣，分多個(gè)業(yè)務(wù)類型和環(huán)節(jié)?，F(xiàn)根據(jù)業(yè)務(wù)類型和環(huán)節(jié)對接口的使用說描述。業(yè)務(wù)場景為領(lǐng)取人員批量查詢。2.3.1 領(lǐng)取人員批量查詢 領(lǐng)取人員批量查詢上傳引入相關(guān)包，對文件上傳參數(shù)對象設(shè)置，調(diào)用sendandreceiveasync方法，該方法會拋出異常import java.io.inputstreamimport com.icss.client.fileuploadagent;import com.icss.clien

32、t.fileuploadparams;import com.icss.client.fileuploadresponse;fileuploadparams upparams = new fileuploadparams();/ 對upparams進(jìn)行封裝.fileuploadagent fileupagent = new fileuploadagent();fileuploadresponse fileuploadresponse = fileupagent.sendandreceiveasync(upparams);string errorflag = fileuploadresponse.

33、geterrorflag();/ 針對其中錯(cuò)誤做出一些處理(以下以209、211、212和215為例)if (209.equals(errorflag) | 211.equals(errorflag)| 212.equals(errorflag) | 215.equals(errorflag) / 針對錯(cuò)誤進(jìn)行處理 . 通用查詢（查詢領(lǐng)取待遇人員批量查詢結(jié)果）commqueryagent commqueryagent = new commqueryagent();map queryparams = new hashmap();/ 對queryparams進(jìn)行封裝.commquer

34、yagent.setqueryparams(queryparams);commqueryresponse commqueryresponse = commqueryagent.query();string errorflag = commqueryresponse.geterrorflag();/ 針對其中錯(cuò)誤做出一些處理(以下以209、211、212和215為例)if (209.equals(errorflag) | 211.equals(errorflag)| 212.equals(errorflag) | 215.equals(errorflag) / 針對錯(cuò)誤進(jìn)行處理 .

35、 錯(cuò)誤文件列表查詢查詢出所有的錯(cuò)誤文件以便下載錯(cuò)誤文件：errfilelistqueryparams querylistparams = new errfilelistqueryparams()/ 對queryparams進(jìn)行設(shè)值封裝.errfilelistqueryagent filedownagent = new errfilelistqueryagent();errfilelistqueryresponse errfilelistresponse = filedownagent.sendandgetqueryresult(querylistparams);string errorflag

36、 = errfilelistresponse.geterrorflag();/ 針對其中錯(cuò)誤做出一些處理(以下以209、211、212和215為例)if (209.equals(errorflag) | 211.equals(errorflag)| 212.equals(errorflag) | 215.equals(errorflag) / 針對錯(cuò)誤進(jìn)行處理 . 錯(cuò)誤文件下載errfiledownloadparams errdownparams = new errfiledownloadparams()/ 對errdownparams進(jìn)行設(shè)值封裝.errfiledownload

37、agent filedownagent = new errfiledownloadagent();errfiledownloadresponse errfiledownloadresponse = filedownagent.sendanddownloaderrfile(errdownparams);string errorflag = errfiledownloadresponse.geterrorflag();/ 針對其中錯(cuò)誤做出一些處理(以下以209、211、212和215為例)if (209.equals(errorflag) | 211.equals(errorflag)| 212.

38、equals(errorflag) | 215.equals(errorflag) / 針對錯(cuò)誤進(jìn)行處理 .3 c接口使用說明3.1 c接口api說明3.1.1 上傳 fileuploadagentinit功能簡介初始化上傳代理。接口名稱long fileuploadagentinit ()參數(shù)說明入?yún)⒄f明無出參說明無返回值fileuploadagent的句柄。 setfileuploadparams功能簡介設(shè)置上傳參數(shù)。接口名稱char *setfileuploadparams(long handle, char* pparamname, char* pparam

39、value)參數(shù)說明入?yún)⒄f明nhandle：fileuploadagent的句柄；pparamname：參數(shù)名稱，具體支持的參數(shù)見下表；pparamvalue：參數(shù)值。出參說明 無返回值“000”為成功，其余為失敗，具體錯(cuò)誤參見錯(cuò)誤代碼表。參數(shù)表：參數(shù)名參數(shù)常量定義參數(shù)說明組織機(jī)構(gòu)代碼upload_orgid請求上傳文件的經(jīng)辦機(jī)構(gòu)的行政區(qū)劃編碼業(yè)務(wù)類型代碼upload_buzztype如”t01011”上傳方式upload_sendtype“1”-文件方式，”2”-流方式數(shù)據(jù)文件類型upload_datafiletype傳輸?shù)臄?shù)據(jù)文件類型,1-txt文件文件名upload_uploadfile

40、name請求上傳的文件名證書類型upload_certtype使用的證書類型,”2”-設(shè)備證書。文件流upload_uploadstream文件流險(xiǎn)種范圍upload_xzscope險(xiǎn)種范圍，如110，310等。具體見java語言中的具體說明 fileuploadsendandreceive功能簡介將請求信息發(fā)送給服務(wù)器，上傳數(shù)據(jù)。 接口名稱char* fileuploadsendandreceive (long nhandle)參數(shù)說明入?yún)⒄f明fileuploadagent的句柄出參說明 無返回值“000”為成功，其余為失敗，具體錯(cuò)誤參見錯(cuò)誤代碼表。 getfil

41、euploadresponse功能簡介獲取上傳文件處理描述信息。接口名稱char* getfileuploadresponse(long nhandle,char* pparamname)參數(shù)說明入?yún)⒄f明nhandle :fileuploadagent的句柄pparamname：參數(shù)名稱，具體支持的參數(shù)見下表；出參說明 無返回值參數(shù)的值參數(shù)表：參數(shù)名參數(shù)常量定義參數(shù)說明錯(cuò)誤代碼upload_errorflag“000”為成功，其余為失敗，具體錯(cuò)誤參見錯(cuò)誤代碼表。返回信息描述upload_retmsg返回的具體信息異常堆棧upload_stacktrace異常的代碼堆棧 fileu

42、ploadagentend功能簡介釋放上傳代理。接口名稱char* fileuploadagentend (long nhandle)參數(shù)說明入?yún)⒄f明fileuploadagent的句柄出參說明 無返回值“000”為成功，其余為失敗，具體錯(cuò)誤參見錯(cuò)誤代碼表。3.1.2 通用查詢 commqueryagentinit功能簡介初始化通用查詢代理。接口名稱long commqueryagentinit ()參數(shù)說明入?yún)⒄f明無出參說明無返回值commqueryagent的句柄 setcommqueryparams功能簡介設(shè)置通用查詢參數(shù)。接口名稱char* setcommq

43、ueryparams(int nhandle, char* pparamname, char* pparamvalue)參數(shù)說明入?yún)⒄f明nhandle：commqueryanget的句柄；pparamname：參數(shù)名稱，具體支持的參數(shù)見下表；pparamname：參數(shù)值。出參說明 無返回值“000”為成功，其余為失敗，具體錯(cuò)誤參見錯(cuò)誤代碼表。參數(shù)表（通用查詢除以下參數(shù)外還可使用額外參數(shù)）：參數(shù)名參數(shù)常量定義參數(shù)說明組織機(jī)構(gòu)代碼commquery_orgid請求下載業(yè)務(wù)數(shù)據(jù)文件的組織機(jī)構(gòu)代碼業(yè)務(wù)類型commquery_buzztype請求下載的業(yè)務(wù)數(shù)據(jù)類型數(shù)據(jù)類型commquery_datafi

44、letype下載的數(shù)據(jù)文件類型。1txt文件（目前只支持txt文件）證書類型commquery_certtype使用的證書類型。1-用戶證書，2-服務(wù)器證書險(xiǎn)種范圍commquery _xzscope險(xiǎn)種范圍，如110，310等。具體見java語言中的具體說明 commquerysendandreceive功能簡介將請求信息發(fā)送給服務(wù)器，進(jìn)行查詢操作。接口名稱char* commquerysendandreceive (long nhandle)參數(shù)說明入?yún)⒄f明commqueryagent的句柄出參說明 無返回值“000”為成功，其余為失敗，具體錯(cuò)誤參見錯(cuò)誤代碼表。

45、 getcommqueryresponse功能簡介獲取通用查詢結(jié)果。接口名稱char* getcommqueryresponse (long nhandle,char* pparamname)參數(shù)說明入?yún)⒄f明nhandle :commqueryagent的句柄pparamname：參數(shù)名稱，具體支持的參數(shù)見下表；出參說明 無返回值參數(shù)的值參數(shù)表：參數(shù)名參數(shù)常量定義參數(shù)說明錯(cuò)誤代碼commquery_errorflag“000”為成功，其余為失敗，具體錯(cuò)誤參見錯(cuò)誤代碼表。返回信息描述commquery _retmsg返回的具體信息異常堆棧commquery_stacktrace異常的代碼堆棧數(shù)據(jù)

46、文件名commquery_downfilename查詢結(jié)果文件名數(shù)據(jù)文件內(nèi)容commquery_downstream查詢數(shù)據(jù)結(jié)果 commqueryagentend功能簡介釋放通用查詢代理。接口名稱char* commqueryagentend (long nhandle)參數(shù)說明入?yún)⒄f明commqueryanget的句柄出參說明 無返回值“000”為成功，其余為失敗，具體錯(cuò)誤參見錯(cuò)誤代碼表。3.1.3 錯(cuò)誤文件下載 errfiledownloadagentinit功能簡介初始化下載代理。接口名稱long filedownloadagentinit ()參數(shù)說明入?yún)⒄f明無出參說明無返回值errfiledownloadagent的句柄 seterrfiledownloadparams功能簡介設(shè)置下載錯(cuò)誤