Extensions Image, Audio et Vidéo Administration et programmation
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'image est stockée dans un fichier externe, vous devez
communiquer le nom du fichier ou le descripteur d'image à l'API qui
utilise la variable d'environnement DB2IMAGEPATH pour déterminer
l'emplacement du fichier. Le fichier doit être accessible à partir
du poste client.
- Si l'image est stockée dans une colonne, vous devez communiquer le
descripteur d'image à l'API. L'application doit être
connectée à la base de données et avoir accès en lecture à la table dans
laquelle l'image est stockée.
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 ]