RFX_Binary_Bulk

位元組資料傳輸多行從 ODBC 資料來源的資料行至對應的陣列在 CRecordset衍生物件的。

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

參數

pFX
CFieldExchange 物件的指標。這個物件包含資訊定義函式的每個呼叫的內容。如需詳細資訊，請參閱文件資料錄欄位交換:RFX 的運作方式。
szName
資料行的名稱。
prgByteVals
BYTE 值陣列的指標。這個陣列會儲存資料來源中要傳送的資料至資料錄集。
prgLengths
陣列的指標長度的整數。這個陣列在位元組陣列中的每個值會存放長度所指向的 prgByteVals。請注意將儲存值 SQL_NULL_DATA ，如果對應的資料項目包含 Null 值。如需詳細資訊，請參閱《 ODBC SDK 程式設計人員參考》的ODBC API 函式 SQLBindCol 。
nMaxLength
允許在陣列中儲存值的長度所指向的 prgByteVals。若要確保資料不會被截斷，請將這個值以配合您所需的最大的資料項目。

資料來源資料行可有 SQL_BINARY、 SQL_VARBINARY或 SQL_LONGVARBINARY的 ODBC 型別。資料錄集必須定義型別指標的欄位資料成員至 BYTE。

如果您使用 prgByteVals 和 prgLengths 對 NULL，則它們指向的陣列會自動配置，與大小等於資料列集大小。

注意事項
大量資料錄欄位只由資料來源傳送交換資料至資料錄集物件。若要讓您的資料錄集是可更新的，您必須使用 ODBC API 函式 SQLSetPos。