d5000商用數(shù)據(jù)庫(kù)程序員手冊(cè)范本-展示頁(yè)
2025-07-04 06:24本頁(yè)面
【正文】 r為可執(zhí)行的sql語(yǔ)句，返回true為執(zhí)行成功，返回false為執(zhí)行失敗。}Retcode = g_CDci. FreeReadData(attrs, attr_num,amp。attrs ,amp。rec_num, amp。recode = (‘His’,’hisdb’,’hisdb’,error)。 調(diào)用方法class CDci g_CDci。error1)。buf,error)If(Retcode !=True){ Printf(“ the error no is %d and the error descr is %s “,)。attr_num,amp。Retcode = (‘select * from aaa’,amp。int retcode；Error_info error1。和GetColAttr接口搭對(duì)。buf,error)If(Retcode !=True){ Printf(“ the error no is %d and the error descr is %s “,)。attr_num,amp。}Retcode = (‘select * from aaa’, 1000,amp。attrs ,amp。rec_num, amp。Char *attrs,*buf。Int retcode；Retcode = (‘HIS’,’hisdb’,’hisdb’,error)。和FreeReadData搭對(duì)應(yīng)用，以便對(duì)內(nèi)存進(jìn)行釋放。rec_numout返回應(yīng)用的處于活動(dòng)狀態(tài)的機(jī)器名attr_numOut返回應(yīng)用的處于活動(dòng)狀態(tài)的機(jī)器號(hào)attrsOut數(shù)據(jù)集各個(gè)屬性的描述。Int retcode；Retcode = (error)。 處理過(guò)程及返回值說(shuō)明在程序和數(shù)據(jù)庫(kù)交互工作完成以后，需要通知數(shù)據(jù)庫(kù)釋放為該客戶端鏈接所開的資源，調(diào)應(yīng)該接口可以完成上述工作。 數(shù)據(jù)庫(kù)斷開連接DisConnectDisConnect(ErrorInfo_t* error) 參數(shù)描述表 12接口參數(shù)輸入輸出參數(shù)（返回值）說(shuō)明備注errorOUT錯(cuò)誤信息返回值OUT1：正確斷開和數(shù)據(jù)庫(kù)的連接情況。Int Retcode。錯(cuò)誤結(jié)構(gòu)中包括發(fā)生錯(cuò)誤的文件名，發(fā)生錯(cuò)誤的文件的行，數(shù)據(jù)庫(kù)的返回的錯(cuò)誤號(hào)，數(shù)據(jù)庫(kù)返回的錯(cuò)誤描述。并可以利用該類的其他接口進(jìn)行和數(shù)據(jù)庫(kù)的交互工作。 處理過(guò)程及返回值說(shuō)明在需要和數(shù)據(jù)庫(kù)交互時(shí)首先需要調(diào)用該接口進(jìn)行連接工作，數(shù)據(jù)庫(kù)客戶端將用戶名、密碼等相關(guān)信息傳遞給服務(wù)器，連接數(shù)據(jù)庫(kù)成功后該類將獲得環(huán)境句柄evnhp，服務(wù)句柄svchp，錯(cuò)誤句柄errhp，認(rèn)證句柄authp。errorOUT帶有錯(cuò)誤信息的結(jié)構(gòu)。user_nameIN用戶名。. . . .1. 歷史數(shù)據(jù)訪問(wèn)服務(wù) 客戶端數(shù)據(jù)庫(kù)調(diào)用接口Dci類 連接數(shù)據(jù)庫(kù)接口ConnectInt Connect(const char* server, const char* user_name, const char* pasword, ErrorInfo_t* error) 參數(shù)描述表 11接口參數(shù)輸入輸出參數(shù)（返回值）說(shuō)明備注serverIN數(shù)據(jù)庫(kù)服務(wù)名。類似oracle中的tnsnames中描述的數(shù)據(jù)服務(wù)名。paswordIN用戶密碼。返回值OUT正確返回True，錯(cuò)誤返回False。其中evnhp、svchp、authp為全局變量。正確返回True，錯(cuò)誤返回False。 調(diào)用方法class CDci g_CDci；Error_Info error。Retcode = (‘HIS’ , ‘hisdb’, ‘hisdb’,error)。0：因各種原因沒有正確結(jié)束。 調(diào)用方法class CDci g_CDci。 從商用庫(kù)讀取數(shù)據(jù) 參數(shù)描述int CDci::ReadData (IN const char *query, OUT int *rec_num, OUT int *attr_num,OUT struct ColAttr ** attrs,OUT char **buf,ErrorInfo_t* error)int CDci::ReadData (IN const char *query,IN int top_number, OUT int *rec_num, OUT int *attr_num,OUT struct ColAttr ** attrs,OUT char **buf,ErrorInfo_t* error)表 13接口參數(shù)輸入/輸出參數(shù)（返回值）說(shuō)明備注queryInSql字符串執(zhí)行命令top_numberIn取數(shù)據(jù)集的前top_number行如果為1，則將符合條件的所有結(jié)果集缺省全部輸出。bufOut數(shù)據(jù)集的首指針errorOut錯(cuò)誤結(jié)構(gòu)返回值Out1：成功；0：失敗 處理過(guò)程及返回值說(shuō)明通過(guò)該接口，數(shù)據(jù)庫(kù)會(huì)根據(jù)query從數(shù)據(jù)庫(kù)讀取數(shù)據(jù)并返回相關(guān)數(shù)據(jù)，rec_num為返回的數(shù)據(jù)行數(shù)，attr_num為返回的屬性的個(gè)數(shù)，attrs為返回的列屬性數(shù)組的頭指針，buf為按照先行后列規(guī)則排列的數(shù)據(jù)集合，error為接口返回錯(cuò)誤結(jié)構(gòu)，接口成功后error為空，接口失敗后需要讀取error的內(nèi)容定位數(shù)據(jù)庫(kù)錯(cuò)誤。 調(diào)用方法class CDci g_CDci。Int rec_num,attr_num。Retcode = (‘select * from aaa’,amp。attr_num,amp。buf,error)If(Retcode !=True){ Printf(“ the error no is %d and the error descr is %s “,)。rec_num, amp。attrs ,amp。} 釋放數(shù)據(jù)集列屬性描述結(jié)構(gòu)指針，通常和ReadData接口聯(lián)合使用 參數(shù)描述void CDci::FreeColAttrData(ColAttr_t *col_attr, int cols)表 14接口參數(shù)輸入/輸出參數(shù)（返回值）說(shuō)明備注col_attrIn列屬性頭指針的描述colsIn列個(gè)數(shù)返回值Out1：成功；0：失敗 處理過(guò)程及返回值說(shuō)明在使用ReadData接口取數(shù)成功后，輸入ReadData接口所開的列屬性的頭指針和列的個(gè)數(shù)，該接口會(huì)依次釋放掉數(shù)據(jù)集合列屬性集中所消耗內(nèi)存，確保沒有內(nèi)存泄漏。 調(diào)用方法
環(huán)評(píng)公示相關(guān)推薦
鄂ICP備17016276號(hào)-1