Image、Audio 及 Video Extenders 管理與程式設計

QbQueryNameSearch


影像 音效 視訊
X    

搜尋 QBIC 型錄, 以找出符合查詢物件中所含之搜尋準則的影像。 查詢物件是以其名稱做為識別。 搜尋結果 (內含影像 handle 與其 QBIC 搜尋範圍) 會儲存在從屬站記憶體的結果陣列中。 並且會根據結果的範圍加以排序。

註:

  1. 僅適用於 EEE︰ 已分割資料庫環境中不支援 QbQueryNameSearch。

  2. 在未來版次中,非分割資料庫環境也不支援 QbQueryNameSearch。若要儲存查詢,您應該使用 QbQueryGetString 以取得查詢字串,並儲存該字串供稍後應用程式之使用。

授權

選取

檔案庫
OS/2 與 Windows AIX、HP-UX 及 Solaris
dmbqqry.lib libdmbqqry.a (AIX)

libdmbqqry.sl (HP-UX)

libdmbqqry.so (Solaris)

併入檔

dmbqbapi.h

語法

SQLRETURN QbQueryNameSearch(
      char *qName,
      char *tableName,
      char *columnName,
      SQLINTEGER maxReturns,
      QbQueryScope* scope,
      SQLINTEGER resultType,
      SQLINTEGER* count,
      QbResult* returns
      );

參數

qName (in)
查詢物件的名稱。

tableName (in)
內含您要搜尋之影像直欄的表格名稱。

columnName (in)
影像直欄的名稱。必須為影像資料啟用直欄。

maxReturns (in)
您希望傳回之影像的數目上限。

scope (in) (保留)
必須設為 0 (NULL)

resultType (in) (保留)
必須設為 qbiArray。

count (out)
指向所傳回之影像數目的指標。假設傳回 0, 請確定您已對查詢物件中的所有特性, 編目影像直欄。

returns (out)
指向保有傳回結果之 QbResult 結構陣列的指標。 請確定您所配置的緩衝區大小放得下您所要的全部結果。

錯誤碼

qbiECinvalidQueryHandle
您指定的查詢物件 handle, 所參照的查詢物件無效。

範例

為員工表格之圖片直欄中的已編目影像,執行查詢 FSHAVGCOL。確定所傳回的影像不超過 6 個:

#include <dmbqbapi.h>
rc = QbQueryNameSearch("fshavgcol",
       "employee", "picture",
       6, 0, qbiArray, &count, &returns);


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