IBM Books

Image Extender、Audio Extender 和 Video Extender 管理和程序设计

DBiGetReferencedFiles


图象 音频 视频
X    

返回用户表的图象列中引用的文件的名称。若某个文件不可存取(例如, 不能使用环境变量说明解析其文件名),则文件名前面有一个星号。此 API 不使用 FILEREF 数据结构的 FILENAME 字段,因此将其设置为 NULL。在调用此 API 之前, 应用程序必须与数据库相连。

重要的是在调用此 API 之后释放它所分配的资源。特别是,必须释放 filelist 数据结构。

授权

对搜索的所有用户表和相关联的管理支持表中启用的图象列的 SELECT 特权

库文件
OS/2 和 Windows AIX、HP-UX 和 Solaris
dmbimage.lib libdmbimage.a (AIX)

libdmbimage.sl (HP-UX)

libdmbimage.so (Solaris)

包含文件

dmbimage.h

语法

long DBiGetReferencedFiles(
      char *tableName,
      long *count,
      FILEREF *(*fileList)
      );

参数

tableName(输入)
限定的、未限定的或空的表名。若指定了表名,则搜索该表中对文件的引用。若指定了空值,则搜索当前用户 ID 所拥有的所有表。

count(输出)
输出列表中的项目数。

fileList(输出)
表中引用的文件的列表。

错误码

MMDB_SUCCESS
对 API 调用的处理成功完成。

MMDB_RC_NOT_CONNECTED
应用程序没有与数据库的有效连接。

MMDB_RC_MALLOC
系统不能分配返回结果所需的内存。

列示 employee 表中的图象列中引用的所有文件:

#include <dmbimage.h>
long idx;
 
rc = DBiGetReferencedFiles("employee",
       &count, &filelist);


[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 ]