RFX_Byte_Bulk

更新 : 2007 年 11 月

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

void RFX_Byte_Bulk(
   CFieldExchange* pFX,
   LPCTSTR szName,
   BYTE** prgByteVals,
   long** prgLengths 
);

パラメータ

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

データソース列は、SQL_TINYINT の ODBC 型にします。レコードセットでは、BYTE へのポインタ型のフィールドデータメンバを定義する必要があります。

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

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