Export (0) Print
Expand All
TRY
Expand Minimize
This topic has not yet been rated - Rate this topic

RFX_Bool_Bulk

Transfers multiple rows of Boolean data from a column of an ODBC data source to a corresponding array in a CRecordset-derived object.

void RFX_Bool_Bulk(
   CFieldExchange* pFX,
   LPCTSTR szName,
   BOOL** prgBoolVals,
   long** prgLengths 
);

Parameters

pFX
A pointer to a CFieldExchange object. This object contains information to define the context for each call of the function. For more information, see the article Record Field Exchange: How RFX Works.
szName
The name of a data column.
prgBoolVals
A pointer to an array of BOOL values. This array will store the data to be transferred from the data source to the recordset.
prgLengths
A pointer to an array of long integers. This array will store the length in bytes of each value in the array pointed to by prgBoolVals. Note that the value SQL_NULL_DATA will be stored if the corresponding data item contains a Null value. For more details, see the ODBC API function SQLBindCol in the ODBC SDK Programmer's Reference.

Remarks

The data source column must have an ODBC type of SQL_BIT. The recordset must define a field data member of type pointer to BOOL.

If you initialize prgBoolVals and prgLengths to NULL, then the arrays they point to will be allocated automatically, with sizes equal to the rowset size.

Note   Bulk record field exchange only transfers data from the data source to the recordset object. To make your recordset updateable, you must use the ODBC API function SQLSetPos. For an example of how to do this, see the sample DBFETCH.

For more information, see the articles Recordset: Fetching Records in Bulk (ODBC) and Record Field Exchange (RFX).

Example

See RFX_Text_Bulk.

See Also

MFC Macros and Globals | RFX_Binary_Bulk | RFX_Byte_Bulk | RFX_Date_Bulk | RFX_Double_Bulk | RFX_Int_Bulk | RFX_Long_Bulk | RFX_Single_Bulk | RFX_Text_Bulk | CFieldExchange::SetFieldType

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.