IBM Books

Image, Audio, and Video Extenders Administration and Programming

QbQueryListFeatures


Image Audio Video
X    

Returns a current list of features in the query object. The API returns the list to a buffer that you allocate. The following features are supplied with the Image Extender:

Authorization

None.

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 QbQueryListFeatures(
      QbQueryHandle qObj,
      SQLINTEGER bufSize,
      SQLINTEGER* count,
      char *featureNames
      );

Parameters

qObj (in)
The handle of the query object.

bufSize (in)
The size of the featureNames buffer. Use the qbiMaxFeatureName constant as the buffer size. Query object features are identified by a character string name.

count (out)
The number of the returned feature names.

featureNames (out)
The pointer to the array of feature names for the query object. The array is stored in the buffer that you allocate.

Error codes

qbiECinvalidQueryHandle
The query handle that you specified does not reference a valid query.

Examples

Return the number of features in the query object identified by the handle qoHandle. Use the qbiMaxFeatureName constant to determine the size of the buffer you need. Return the feature name to the feats buffer and the number of features to the retCount variable:

#include <dmbqbapi.h>
 
bufSize = qbiMaxFeatureName;
 
rc = QbQueryListFeatures(qoHandle, bufSize,
        &retCount, feats);


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