Extensions Image, Audio et Vidéo Administration et programmation

QbQueryNameCreate


Image Audio Vidéo
X    

Stocke un objet de requête et lui affecte un nom de sorte que vous puissiez l'utiliser dans une fonction utilisateur (UDF). Indiquez le nom et, facultativement, la description de l'objet de la requête.

Remarques :

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

  2. La fonction QbQueryNameCreate 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

Aucune.

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 QbQueryNameCreate(
      QbQueryHandle qObj,
      char *name,
      char *description
      );

Paramètres

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

name (entrée)
Nom de l'objet de la requête. Ce dernier peut comporter jusqu'à 18 caractères.

description (entrée)
Brève description de l'objet de la requête (250 caractères au maximum).

Codes d'erreur

qbiECinvalidQueryHandle
Le descripteur de l'objet de requête indiqué ne fait pas référence à une requête correcte.

Exemples

Affectation d'un nom et d'une description à l'objet de requête créé au moyen de l'API QbQueryCreate :

#include <dmbqbapi.h>
 
rc = QbQueryNameCreate(qHandle,
       "fshavgcol",
       "requête couleur moyenne, 10/15/96");


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