Extensions Image, Audio et Vidéo Administration et programmation
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 :
- Produit EEE uniquement : QbQueryNameSearch n'est
pas pris en charge dans un environnement de bases de données
partitionnées.
- 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 ]