Image Extender、Audio Extender 和 Video Extender 管理和程序设计
在客户机上打开图象浏览器并显示图象。可将图象存储在图象列或外部文件中:
- 若将图象存储在外部文件中,则可将文件的名称或图象句柄传送至此 API。此 API 使用客户机环境变量 DB2IMAGEPATH 来解析文件位置。该文件必须可以从客户工作站进行存取。
- 若将图象存储在列中,则必须将图象句柄传送至此 API。应用程序必须与数据库相连,
且必须对其中存储图象的表具有读存取权。
若浏览器不能直接存取图象,则 Extender 将在 DB2IMAGETEMP
环境变量中指定的目录中创建一个临时文件。然后,Extender 显示临时文件中的图象。
授权
若浏览列中的图象,则选择用户表上的权限。
库文件
OS/2 和 Windows
| AIX、HP-UX 和 Solaris
|
dmbimage.lib
| libdmbimage.a (AIX)
|
| libdmbimage.sl (HP-UX)
|
| libdmbimage.so (Solaris)
|
包含文件
dmbimage.h
语法
浏览存储在列中的图象
long DBiBrowse(
char *browserName,
MMDB_PLAY_HANDLE,
DB2Image *imageHandle,
waitFlag
);
语法
浏览存储为文件的图象
long DBiBrowse(
char *browserName,
MMDB_PLAY_FILE,
char *fileName,
waitFlag
);
参数
- browserName(输入)
- 图象浏览器的名称。若设置为 NULL,则使用 DB2IMAGEBROWSER 环境变量指定的缺省图象浏览器。
- MMDB_PLAY_HANDLE(输入)
- 一个常量,指示将图象存储成 BLOB。
- MMDB_PLAY_FILE(输入)
- 一个常量,指示将图象存储成可从客户机存取的文件。
- imageHandle(输入)
- 图象的句柄。在您浏览列中的图象时,必须传送此参数。若图象句柄代表外部文件,则使用客户机环境变量 DB2IMAGEPATH 来解析文件位置。
- fileName(输入)
- 包含图象的文件的名称。
- waitFlag(输入)
- 一个常量,指示程序在继续之前是否等待用户关闭浏览器。MMDB_PLAY_WAIT 在应用程序所在的线程中运行浏览器。MMDB_PLAY_NO_WAIT 在另一线程中运行浏览器。
错误码
- MMDB_SUCCESS
- 对 API 调用的处理成功完成。
- MMDB_RC_NO_AUTH
- 调用者没有正确的存取权限。
- MMDB_RC_NOT_CONNECTED
- 应用程序没有与数据库的有效连接。
例
显示由 imageHandle 标识的图象。在应用程序所在的线程中运行缺省浏览器:
#include <dmbimage.h>
rc = DBiBrowse(NULL, MMDB_PLAY_HANDLE,
imageHandle, MMDB_PLAY_WAIT);
[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 ]