Extensions Image, Audio et Vidéo Administration et programmation

QbQuerySearch


Image Audio Vidéo
X    

Recherche dans le catalogue QBIC les images répondant au critère de recherche indiqué dans un objet de requête. L'objet de la requête est identifié par un descripteur d'objet de requête. Les résultats (comprenant les descripteurs d'image et les scores de recherche QBIC) sont consignés dans un tableau dans la mémoire client. Ils sont triés sur la valeur de leurs scores.

Autorisation

SELECT

Fichier bibliothèque
OS/2 et Windows AIX, HP-UX et Solaris
dmbqqry.lib libdmbqqry.a (AIX)

libdmbqqry.sl (HP-UX)

libdmbqqry.so (Solaris)

Fichier d'inclusion

dmbqbapi.h

Syntaxe

SQLRETURN QbQuerySearch(
      QbQueryHandle qObj,
      char *tableName,
      char *columnName,
      SQLINTEGER maxReturns,
      QbQueryScope* scope,
      SQLINTEGER resultType,
      SQLINTEGER* count,
      QbResult* returns
      );

Paramètres

qObj (entrée)
Descripteur de l'objet de la requête.

tableName (entrée)
Nom de la table contenant la colonne Image dans laquelle vous souhaitez faire la recherche.

columnName (entrée)
Nom de la colonne Image. La colonne doit être activée pour les données image.

maxReturns (entrée)
Nombre maximal d'images que vous souhaitez renvoyer.

scope (entrée) (Réservé)
Doit avoir la valeur 0 (NULL).

resultType (entrée) (Réservé)
Doit avoir la valeur de qbiArray.

count (sortie)
Pointeur sur le nombre d'images renvoyé. Si la valeur zéro est renvoyée, assurez-vous que la colonne Image est cataloguée pour toutes les fonctions dans l'objet de requête.

returns (sortie)
Pointeur sur le tableau des structures QbResult contenant les résultats renvoyés. Assurez-vous que vous avez affecté suffisamment de mémoire tampon pour prendre en charge les résultats attendus.

Codes d'erreur

qbiECinvalidQueryHandle
Le descripteur de l'objet de requête spécifié ne fait pas référence à un objet de requête correct.

Exemples

Interrogation des images cataloguées dans la colonne Photo de la table Employés. Assurez-vous que le nombre d'images renvoyé ne dépasse pas six.

#include <dmbqbapi.h>
 
rc = QbQuerySearch(qHandle, "Employés",
       "picture", 6, 0, qbiArray,
       &count, &returns);


[ Début de page | Page précédente | Page suivante | Table des matières | Index ]