IBM Books

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

QbListFeatures


图象 音频 视频
X    

返回目录中当前包括的活动特性的列表。该列表被返回至您分配的缓冲区。

授权

选择

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

libdmbqbapi.sl (HP-UX)

libdmbqbapi.so (Solaris)

包含文件

dmbqbapi.h

语法

SQLRETURN QbListFeatures(
      QbCatalogHandle cHdl,
      SQLINTEGER bufSize,
      SQLINTEGER *count,
      char *featureNames
      );

参数

cHdl(输入)
指向目录句柄的指针。

bufSize(输入)
缓冲区的大小。要估计所需的缓冲区大小,可使用 QbGetCatalogInfo API 返回的特性计数, 并将该计数乘以最长特性名称的长度。存储在缓冲区中的特性名由空白字符分隔。

count(输出)
返回的特性名称的数目。

featureNames(输出)
缓冲区中的特性名数组。

错误码

qbicECIvalidHandle
目录句柄无效。

qbicECTruncateData
因为返回缓冲区太小,所以返回的数据被截断。

获取句柄 CatHdl 所标识的目录中活动特性的列表。在 featureNames 数组中存储信息。

首先,计算 bufSize,这是列表所需的缓冲区大小。使用 QbGetCatalogInfo API 来返回 catInfo 结构中的特性数。然后将该数目乘以常量 qbiMaxFeatureName,它是最长特性名称的大小:

#include <dmbqbapi.h>
 
rc = QbGetCatalogInfo(CatHdl, &catInfo);
 
bufSize =
   catInfo.featureCount*qbiMaxFeatureName;
 
rc = QbListFeatures(CatHdl, bufSize,
       count, featureNames);


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