IBM Books

Image Extender、Audio Extender 和 Video Extender 管理和程序设计

QbQueryNameSearch


图象 音频 视频
X    

在 QBIC 目录中搜索符合查询对象中包含的搜索标准的图象查询对象由其名称标识 结果(包括图象句柄和 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(输入)
查询对象的名称。

tableName(输入)
包含要搜索的图象列的表的名称。

columnName(输入)
图象列的名称。必须对图象数据启用该列。

maxReturns(输入)
要返回的最大图象数。

scope(输入)(保留)
必须设置为 0 (NULL)

resultType(输入)(保留)
必须设置为 qbiArray。

count(输出)
指向返回的图象数的指针。若返回零,则确保对查询对象中的所有特性编目了该图象列。

returns(输出)
指向存放返回结果的 QbResult 结构数组的指针。务必分配足够大的缓冲区来存放期望的所有结果。

错误码

qbiECinvalidQueryHandle
指定的查询对象句柄未引用有效的查询对象。

对 Employee 表的 picture 列中的已编目图象运行查询 FSHAVGCOL: 确保不返回 6 个以上图象:

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


[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 ]