イメージ、オーディオ、およびビデオ・エクステンダー 管理およびプログラミングの手引き

QbQueryListFeatures


イメージ オーディオ ビデオ
O

照会オブジェクト内のフィーチャーの現行リストを戻します。 この API は、割り当てられているバッファーにこのリストを戻します。 イメージ・エクステンダーと共に、次のフィーチャーが提供されています。

許可

なし。

ライブラリー・ファイル
OS/2 および Windows AIX、HP-UX、および Solaris
dmbqqry.lib libdmbqqry.a (AIX)

libdmbqqry.sl (HP-UX)

libdmbqqry.so (Solaris)

インクルード・ファイル

dmbqbapi.h

構文

SQLRETURN QbQueryListFeatures(
      QbQueryHandle qObj,
      SQLINTEGER bufSize,
      SQLINTEGER* count,
      char *featureNames
      );

パラメーター

qObj (in)
照会オブジェクト・ハンドル。

bufSize (in)
featureNames バッファーのサイズ。 qbiMaxFeatureName 定数をバッファー・サイズとして使用します。 照会オブジェクトのフィーチャーは文字ストリング名によって識別されます。

count (out)
戻されるフィーチャー名の数。

featureNames (out)
照会オブジェクトのフィーチャー名を指すポインター。 この配列は、割り振られているバッファーに保管されます。

エラー・コード

qbiECinvalidQueryHandle
指定された照会ハンドルが有効な照会を参照していません。

ハンドル qoHandle によって識別される照会オブジェクトのフィーチャーの数を戻すには、次のようにします。 必要なバッファーのサイズを判別するには、qbiMaxFeatureName 定数を使用します。 フィーチャー名をフィーチャーのバッファーに戻し、フィーチャーの数を retCount 変数に戻します。

#include <dmbqbapi.h>
bufSize = qbiMaxFeatureName;
rc = QbQueryListFeatures(qoHandle, bufSize,
        &retCount, feats);


[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]