IBM Books

Image, Audio, and Video Extenders Administration and Programming

QbQueryStringSearch


Image Audio Video
X    

Searches the QBIC catalog for images that match the search criteria contained in a query string. The results, which include the image handles and their QBIC search scores, are stored in a result array in the client memory. They are sorted according to their scores.

Authorization

Select

Library file
OS/2 and Windows AIX, HP-UX, and Solaris
dmbqqry.lib libdmbqqry.a (AIX)

libdmbqqry.sl (HP-UX)

libdmbqqry.so (Solaris)

Include file

dmbqbapi.h

Syntax

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

Parameters

queryString (in)
The query string.

tableName (in)
The name of the table containing the column of images you want to search.

columnName (in)
The name of the image column. The column must be enabled for image data.

maxReturns (in)
The maximum number of images you want returned.

scope (in) (Reserved)
Must be set to 0 (NULL).

resultType (in) (Reserved)
Must be set to qbiArray.

count (out)
The pointer to the number of images returned. If zero is returned, make sure the image column is cataloged for all the features in the query string.

returns (out)
The pointer to the array of QbResult structures that hold the returned results. Make sure you allocate the buffer large enough to hold all the results you expect.

Error codes

qbiECinvalidQueryString
The query string you specified is invalid.

Examples

Query the cataloged images in the picture column of the employee table. Make sure that no more than six images are returned:

#include <dmbqbapi.h>
 
rc = QbQueryStringSearch("QbColorFeatureClass color=<255, 0, 0>"
       "employee",
       "picture", 6, 0, qbiArray,
       &count, &returns);


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]