Extensions Image, Audio et Vidéo Administration et programmation

QbQueryNameSearch


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 son nom. 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. Les résultats sont triés sur la valeur de leurs scores.

Remarques :

  1. Produit EEE uniquement : QbQueryNameSearch n'est pas pris en charge dans un environnement de bases de données partitionnées.

  2. La fonction QbQueryNameSearch ne sera plus utilisée dans les prochaines versions des environnements de bases de données non partitionnées. Pour sauvegarder une requête en vue de l'utiliser ultérieurement dans votre application, il est donc conseillé d'extraire la chaîne de requête à l'aide de l'API QbQueryGetString.

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 QbQueryNameSearch(
      char *qName,
      char *tableName,
      char *columnName,
      SQLINTEGER maxReturns,
      QbQueryScope* scope,
      SQLINTEGER resultType,
      SQLINTEGER* count,
      QbResult* returns
      );

Paramètres

qName (entrée)
Nom 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'objetde la requête indiqué ne fait pas référence à un objet de requête correct.

Exemples

Exécution de la requête FSHAVGCOL sur les 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 = QbQueryNameSearch("fshavgcol",
       "Employés", "photo",
       6, 0, qbiArray, &count, &returns);


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