Extensions Image, Audio et Vidéo Administration et programmation

DBiBrowse


Image Audio Vidéo
X    

Ouvre l'afficheur d'images sur le poste client et affiche une image. L'image peut être stockée dans une colonne Image ou dans un fichier externe.

Si l'afficheur ne peut pas accéder directement à l'image, l'extension crée un fichier temporaire dans le répertoire défini dans la variable d'environnement DB2IMAGETEMP. L'extension affiche ensuite l'image à partir du fichier temporaire.

Autorisation

SELECT sur la table utilisateur si une image est visualisée à partir d'une colonne.

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

libdmbimage.sl (HP-UX)

libdmbimage.so (Solaris)

Fichier d'inclusion

dmbimage.h

Syntaxe

Lecture d'un objet image stocké dans une colonne

long DBiBrowse(
      char *browserName,
      MMDB_PLAY_HANDLE,
      DB2Image *imageHandle,
      waitFlag
      );

Syntaxe

Lecture d'un objet image stocké dans un fichier

long DBiBrowse(
      char *browserName,
      MMDB_PLAY_FILE,
      char *fileName,
      waitFlag
      );

Paramètres

browserName (entrée)
Nom de l'afficheur d'images. Si ce paramètre est défini par NULL, l'afficheur d'images par défaut défini par la variable d'environnement DB2IMAGEBROWSER est utilisé.

MMDB_PLAY_HANDLE (entrée)
Constante qui indique que l'image est stockée en tant qu'objet BLOB.

MMDB_PLAY_FILE (entrée)
Constante qui indique que l'image est stockée sous forme de fichier accessible à partir du poste client.

imageHandle (entrée)
Descripteur de l'image. Ce paramètre doit être fourni lorsque vous visualisez une image dans une colonne. Si le descripteur d'image représente un fichier externe, la variable d'environnement client DB2IMAGEPATH est utilisée pour déterminer l'emplacement du fichier.

fileName (entrée)
Nom du fichier contenant l'image.

waitFlag (entrée)
Constante qui indique si le programme attend que l'utilisateur arrête l'afficheur avant de continuer. Le paramètre MMDB_PLAY_WAIT entraîne la mise en oeuvre de l'afficheur dans la même unité d'exécution que l'application. Le paramètre MMDB_PLAY_NO_WAIT entraîne la mise en oeuvre de l'afficheur dans une unité d'exécution distincte.

Codes d'erreur

MMDB_SUCCESS
Le traitement de l'appel d'API a abouti.

MMDB_RC_NO_AUTH
Le demandeur ne dispose pas des droits d'accès corrects.

MMDB_RC_NOT_CONNECTED
L'application n'a pas établi une connexion correcte à une base de données.

Exemples

Affichage de l'image identifiée par le descripteur d'image. Mise en oeuvre de l'afficheur par défaut dans la même unité d'exécution que l'application.

#include <dmbimage.h>
 
rc = DBiBrowse(NULL, MMDB_PLAY_HANDLE,
       imageHandle, MMDB_PLAY_WAIT);


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