RFX_Binary_Bulk

更新 : 2007 年 11 月

複数行のバイトデータを ODBC データソースの列から CRecordset 派生オブジェクト内の対応する配列に転送します。

void RFX_Binary_Bulk(
   CFieldExchange* pFX,
   LPCTSTR szName,
   BYTE** prgByteVals,
   long** prgLengths,
   int nMaxLength 
);

パラメータ

pFX
CFieldExchange オブジェクトへのポインタを返します。このオブジェクトは、関数の各呼び出しのコンテキストを定義する情報を保持します。詳細については、「レコードフィールドエクスチェンジ : RFX の動作のしくみ」を参照してください。
szName
データ列の名前。
prgByteVals
BYTE 型の値の配列へのポインタ。この配列には、データソースからレコードセットへコピーされるデータが格納されます。
prgLengths
長整数型 (long) の配列へのポインタ。この配列には、prgByteVals で指定された配列内のそれぞれの値の長さが、バイト単位で保存されます。対応するデータアイテムの値が Null の場合、SQL_NULL_DATA の値が格納されます。詳細については、『ODBC SDK Programmer's Reference』の「ODBC API Functions」の「SQLBindCol」を参照してください。
nMaxLength
prgByteVals によって指定された配列に格納できる値の最大長。データが切り捨てられないように、最大のデータアイテムを格納するのに十分大きな値を指定してください。

データソース列は、SQL_BINARY、SQL_VARBINARY、または SQL_LONGVARBINARY のいずれかの ODBC 型です。レコードセットでは、BYTE へのポインタ型のフィールドデータメンバを定義する必要があります。

prgByteVals と prgLengths を NULL で初期化した場合は、行セットのサイズと等しいサイズの配列が、自動的に割り当てられます。

メモ :
バルクレコードフィールドエクスチェンジでは、データソースからレコードセットオブジェクトにデータが転送されるだけです。レコードセットを更新可能にするには、ODBC API 関数 SQLSetPos を使用する必要があります。