Image、Audio 及 Video Extenders 管理與程式設計

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 (in)
指向型錄之 handle 的指標。

bufSize (in)
您緩衝區的大小。要預估所需的緩衝區大小時, 您可以將 QbGetCatalogInfo API 所傳回的特性數目, 乘上最長特性名稱之長度值,來預估其大小。儲存在緩衝區中的特性名稱, 彼此間會以空白字元隔開。

count (out)
所傳回之特性名稱的數目。

featureNames (out)
您緩衝區中的特性名稱陣列。

錯誤碼

qbicECIvalidHandle
型錄 handle 無效。

qbicECTruncateData
傳回的資料遭到截斷,理由是傳回緩衝區太小。

範例

取得列示,而此列示中列有 handle CatHdl 所識別之型錄內的作用中特性。並且將資訊儲存在 featureNames 陣列中。

首先,先計算 bufSize,此為放置列示時應具備的緩衝區大小。 使用 QbGetCatalogInfo API,將特性數目傳回到 catInfo 結構中。 然後將該數目值乘上常數 qbiMaxFeatureName 值 (此為最長之特性名稱的大小)。

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


[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]