目的
使用搜尋引數在文字直欄所識別的整個文字文件中執行搜尋。 所找到之文字項目的 handle 資料會被寫入結果表格。 等級及相符者個數的相關瀏覽資訊,也會被寫入結果表格。
語法
DESRETURN DesGetSearchResultTable (SQLHDBC hdbc, char *pTableSchema, DESSMALLINT TableSchemaLength, char *pTableName, DESSMALLINT TableNameLength, char *pColumnName, DESSMALLINT ColumnNameLength, char *pSearchArgument, DESSMALLINT ArgumentLength, char *pResultSchema, DESSMALLINT ResultSchemaLength, char *pResultTableName, DESSMALLINT ResultTableNameLength, DESSEARCHOPTION SearchOption, DESBROWSEOPTION BrowseOption, DESBROWSEINFO *pBrowseInfo, DESMESSAGE *pErrorMessage);
函數引數
表 14. DesGetSearchResultTable 引數
資料 類型 | 引數 | 使用 | 說明 |
---|---|---|---|
SQLHDBC | hdbc | 輸入 | 資料庫連接 handle。 |
char * | pTableSchema | 輸入 | 要搜尋的基本表格綱目。 |
DESSMALLINT | TableSchemaLength | 輸入 | 若非 pTableSchema 的長度 (不包括空位元組終止符),即為 DES_NTS。 |
char * | pTableName | 輸入 | 指向所要搜尋之基本表格的名稱的指標。 |
DESSMALLINT | TableNameLength | 輸入 | 若非 pTableName 的長度 (不包括空位元組終止符),即為 DES_NTS。 |
char * | pColumnName | 輸入 | 一種指標,指向所欲執行之文字搜尋所指定的直欄名稱。 該直欄類型必須是 DESTEXTH。 |
DESSMALLINT | ColumnNameLength | 輸入 | 若非 pColumnName 的長度 (不包括空位元組終止符),即為 DES_NTS。 |
char * | pSearchArgument | 輸入 | 指向文字搜尋引數的指標。 |
DESSMALLINT | ArgumentLength | 輸入 | 若非 pSearchArgument 的長度 (不包括空位元組終止符),即為 DES_NTS。 |
char * | pResultSchema | 輸入 | 指向包含結果表格之綱目的指標。 |
DESSMALLINT | ResultSchemaLength | 輸入 | 若非 pSchemaName 的長度 (不包括空位元組終止符),即為 DES_NTS。 |
char * | pResultTableName | 輸入 | 指向結果表格之名稱的指標,而此結果表格是您先前在儲存搜尋結果的地方建立的。 欲取得此表格的結構,請參閱圖 15。 |
DESSMALLINT | ResultTableNameLength | 輸入 | 若非 pResultTableName 的長度 (不包括空位元組終止符),即為 DES_NTS。 |
DESSEARCHOPTION | SearchOption | 輸入 | 一種選項,可決定要要求等級資訊、相符者個數或只要相符之文字文件的 handle。
此選項可判定結果表格的內容 (如用法的說明)。 |
DESBROWSEOPTION | BrowseOption | 輸入 | 已保留。
|
DESBROWSEINFO * | pBrowseInfo | 輸出 | 指向瀏覽資訊的指標,或是指向 NULL 的指標,需視 BrowseOption 的值而定。 |
DESMESSAGE * | pErrorMessage | 輸出 | 執行時所定義的訊息文字。如果發生錯誤,DB2 Text Extender 會傳回錯誤碼及錯誤訊息。 應用程式會依 DES_MAX_MESSAGE_LENGTH 的大小配置該緩衝區。 如果 pErrorMessage 是 NULL 指標, 不會傳回任何錯誤訊息。 |
與資料庫的連線必須經由應用程式呼叫 DesGetSearchResultTable 而建立。
pResultTableName 這個名稱會參照您預先建立的結果表格。 範例目錄中的公用程式 DESRESTB 會為文字 handle 建立結果表格。 在呼叫此函數之後,結果表格會包含識別符合搜尋引數之文字值的資訊。
![]() |
TEXTHANDLE 的資料類型為 DB2TEXTH 或 DB2TEXTFH。 RANK 的資料類型為 DOUBLE。MATCHES 的資料類型為 INTEGER。
pSearchArgument 中的搜尋引數說明於搜尋引數的語法。
如果 BrowseOption 的值為 BROWSE, 則 DB2 Text Extender 會從位於伺服器上的 DB2 Text Extender 搜尋引擎傳回瀏覽資訊。pBrowseInfo 指向瀏覽資訊, 而此資訊是 DesStartBrowseSession 的輸入。 如果 BrowseOption 的值是 NO_BROWSE, 則 pBrowseInfo 會指向 NULL。
回覆碼