Extensions Image, Audio et Vidéo Administration et programmation

QbListFeatures


Image Audio Vidéo
X    

Renvoie la liste des fonctions actuellement actives contenues dans un catalogue. La liste est renvoyée dans la mémoire tampon affectée.

Autorisation

SELECT

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

libdmbqbapi.sl (HP-UX)

libdmbqbapi.so (Solaris)

Fichier d'inclusion

dmbqbapi.h

Syntaxe

SQLRETURN QbListFeatures(
      QbCatalogHandle cHdl,
      SQLINTEGER bufSize,
      SQLINTEGER *count,
      char *featureNames
      );

Paramètres

cHdl (entrée)
Pointeur sur le descripteur du catalogue.

bufSize (entrée)
Capacité de la mémoire tampon. Pour estimer la taille de mémoire tampon nécessaire, vous pouvez utiliser le nombre de fonctions renvoyé par l'API QbGetCatalogInfo et le multiplier par la longueur du nom de fonction le plus long. Les noms de fonctions stockés en mémoire tampon sont séparés par un espace.

count (sortie)
Nombre de noms de fonctions renvoyés.

featureNames (sortie)
Tableau de noms de fonctions dans la mémoire tampon.

Codes d'erreur

qbicECIvalidHandle
Le descripteur de catalogue n'est pas correct.

qbicECTruncateData
Les données sont tronquées car la mémoire tampon de réception est insuffisante.

Exemples

Insertion d'une liste des fonctions actives dans le catalogue identifié par le descripteur CatHdl. Stockage des informations dans le tableau featureNames.

Dans un premier temps, calculez la taille de la mémoire tampon nécessaire. Utilisez l'API QbGetCatalogInfo pour renvoyer le nombre de fonctions dans la structure catInfo. Multipliez ensuite ce nombre par la valeur de la constante qbiMaxFeatureName qui correspond à la taille du nom de fonction le plus long.

#include <dmbqbapi.h>
 
rc = QbGetCatalogInfo(CatHdl, &catInfo);
 
bufSize =
   catInfo.featureCount*qbiMaxFeatureName;
 
rc = QbListFeatures(CatHdl, bufSize,
       count, featureNames);


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