freetds的一些函數介面__函數

1． Dbcmd和dbfcmd

函數原形：

Dbcmd(DBPROCESS *proc,char * sql);

Dbcmd(DBPROCESS *proc, char * format,char *args);
執行個體

Dbcmd(proc,“select * from users where user=‘xingxing’”)；

Char *user=“xingxing”；

Dbfcmd（proc，“select * from users where user=’%s’”，user）；

功能：該函數主要是構造sql語句，一個是帶參數的，一個不帶參數。

2． Dbsqlexec

函數原形：

Dbsqlexec（DBPROCESS *proc）；

執行個體：

Dbsqlexec（proc）；

功能：該函數負責執行你所構造的sql語句。

3． Dbresults

函數原形：

Dbrerults（DBPROCESS *proc）；

執行個體：

Dbrerults（proc）；

功能：得到sql語句的執行結果。傳回值如果為NO_MORE_RESULTS=0，表明sql查詢為空白值（就是沒有一條滿足條件的結果），如果為（FAIL）=-1，表明查詢出錯，如果為（SUCCESS）=1，表明有結果且不為空白。

4． DBROWS（全大寫）

函數原形：

DBROWS（DBPROCESS *proc）；

執行個體：

DBROWS（proc）；

功能：取出一行記錄的資訊。

5． Dbbind

函數原形：

Dbbind（DBPROCESS *proc，int colmn，

執行個體：

dbbind (dbproc, 1, STRINGBIND, (DBINT) 0, (BYTE DBFAR *)x25addr);

功能：將sql查詢出來的結果綁定到一個變數。第一個參數為從資料庫那裡拿的控制代碼，第二個參數是對應你的select語句中查詢需要的欄位（註：必須是按照select順序綁定的，例如select user，password from hist1 ，如果值為1，就是綁定的user），第三個參數是綁定欄位的類型，最後一個參數是綁定的變數。

6．    Dbnextrow

函數原形：

Dbnextrow（DBPROCESS *proc）；

功能：該函數將取出滿足sql語句的每一行，傳回值為0，代表處理結束，傳回值為-1出錯。

7．  Dbcancel

函數原形：

Dbcancel（DBPROCESS *proc）；

功能：清空上次查詢得到的資料集，如果是一個控制代碼的話，每次重新執行select語句之前都要調用它清空結果，不然資料庫會報錯的。

8． Dbclose

函數原形：

Dbclose（DBPROCESS *proc）；

功能：關閉控制代碼。當不再使用時必須關閉控制代碼。

9．  Dbinit

函數原形：Dbinit（）

功能：初識化資料庫連接。傳回值為-1出錯。

10． Dblogin

函數原形：LOGINREC       *Dblogin（）；

          DBSETLUSER(login,SOFT);  //set the database user 

          DBSETLPWD(login,SOFTPASS);//set password

功能：根據使用者名稱和密碼串連資料庫。

11．Dbcount

函數原形：

Dbcount（DBPROCESS *proc）；

功能：該函數將得到sql結果集被處理的行數，可以用它來判斷你的select語句是否得到正確的處理。

12．Dbopen

函數原形：

DBPROCESS * Dbopen（LOGINREC     *login，NULL）；

功能：返回一個操作資料庫的控制代碼。

另外再介紹兩個關於資料庫的出錯資訊的函數：

dberrhandle(int *err);

dbmsghandle(int* err);