Documentation
(C) IBM Corp. 1996, 2000

DB2 Text Extender

DesGetSearchResultTable

目的

使用搜尋引數在文字直欄所識別的整個文字文件中執行搜尋。 所找到之文字項目的 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。

DES_RANK
DES_MATCH
DES_RANKANDMATCH
DES_TEXTHANDLEONLY

此選項可判定結果表格的內容 (如用法的說明)。

DESBROWSEOPTION BrowseOption 輸入 已保留。

DESBROWSEINFO * pBrowseInfo 輸出 指向瀏覽資訊的指標,或是指向 NULL 的指標,需視 BrowseOption 的值而定。
DESMESSAGE * pErrorMessage 輸出 執行時所定義的訊息文字。如果發生錯誤,DB2 Text Extender 會傳回錯誤碼及錯誤訊息。 應用程式會依 DES_MAX_MESSAGE_LENGTH 的大小配置該緩衝區。 如果 pErrorMessage 是 NULL 指標, 不會傳回任何錯誤訊息。

用法

與資料庫的連線必須經由應用程式呼叫 DesGetSearchResultTable 而建立。

pResultTableName 這個名稱會參照您預先建立的結果表格。 範例目錄中的公用程式 DESRESTB 會為文字 handle 建立結果表格。 在呼叫此函數之後,結果表格會包含識別符合搜尋引數之文字值的資訊。

此為結果表格的結構:

圖 15. 結果表格的結構


REQTEXT

TEXTHANDLE 的資料類型為 DB2TEXTH 或 DB2TEXTFH。 RANK 的資料類型為 DOUBLE。MATCHES 的資料類型為 INTEGER。

pSearchArgument 中的搜尋引數說明於搜尋引數的語法

如果 BrowseOption 的值為 BROWSE, 則 DB2 Text Extender 會從位於伺服器上的 DB2 Text Extender 搜尋引擎傳回瀏覽資訊。pBrowseInfo 指向瀏覽資訊, 而此資訊是 DesStartBrowseSession 的輸入。 如果 BrowseOption 的值是 NO_BROWSE, 則 pBrowseInfo 會指向 NULL。

回覆碼

RC_SUCCESS
RC_NO_BROWSE_INFO
RC_SE_NO_DATA
 
RC_ALLOCATION_ERROR
RC_FILE_IO_PROBLEM
RC_INTERNAL_ERROR
RC_INVALID_BROWSE_OPTION
RC_INVALID_PARAMETER
RC_INVALID_SEARCH_OPTION
RC_INVALID_SESSION
RC_PARSER_INVALID_ESCAPE_CHARACTER
RC_PARSER_SYNTAX_ERROR
RC_RESULT_TABLE_NOT_EXIST
RC_SE_COMMUNICATION_PROBLEM
RC_SE_EMPTY_INDEX
RC_SE_EMPTY_QUERY
RC_SE_FUNCTION_DISABLED
RC_SE_FUNCTION_IN_ERROR
RC_SE_INCORRECT_HANDLE
RC_SE_INDEX_DELETED
RC_SE_INDEX_NOT_ACCESSIBLE
RC_SE_INDEX_SUSPENDED
RC_SE_INSTALLATION_PROBLEM
RC_SE_IO_PROBLEM
RC_SE_MAX_NUMBER_OF_BUSY_INDEXES
RC_SE_NOT_ENOUGH_MEMORY
RC_SE_PROCESSING_LIMIT_EXCEEDED
RC_SE_QUERY_TOO_COMPLEX
RC_SE_SERVER_BUSY
RC_SE_SERVER_CONNECTION_LOST
RC_SE_SERVER_NOT_AVAILABLE
RC_SE_UNEXPECTED_ERROR
RC_SE_UNKNOWN_INDEX_NAME
RC_SE_UNKNOWN_SERVER_NAME
RC_SE_WRITE_TO_DISK_ERROR
RC_SQL_ERROR_NO_INFO
RC_SQL_ERROR_WITH_INFO
RC_TEXT_COLUMN_NOT_ENABLED
 
警告:下列回覆碼表示該函數已傳回結果,但可能不是所預期的結果。
 
RC_SE_CONFLICT_WITH_INDEX_TYPE
RC_SE_DICTIONARY_NOT_FOUND
RC_SE_STOPWORD_IGNORED
RC_SE_UNKNOWN_SECTION_NAME
RC_SE_DOCMOD_READ_PROBLEM


[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]