RFX_Binary_Bulk

Artikel
02/26/2013

Überträgt mehrere Zeilen von gelesenen Daten aus einer Spalte einer ODBC-Datenquelle in ein entsprechendes Array in CRecordset abgeleitetes Objekt.

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

Parameter

pFX
Einen Zeiger auf ein CFieldExchange-Objekt.Dieses Objekt enthält Informationen, um den Kontext für jeden Aufruf der Funktion zu definieren.Weitere Informationen finden Sie im Artikel Datensatzfeldaustausch: Wie Funktionsweise von RFX.
szName
Der Name einer Datenspalte.
prgByteVals
Ein Zeiger auf ein Array von Werten BYTE.Dieses Array speichert die von der Datenquelle übertragen werden Daten auf das Recordset.
prgLengths
Ein Zeiger auf ein Array von langen ganzen Zahlen.Dieses Array speichert die Länge in Bytes jedes Werts im Array, auf die von prgByteVals dargestellt wird.Beachten Sie, dass der Wert SQL_NULL_DATA gespeichert wird, wenn das entsprechende Datenelement einen NULL-Wert enthält.Weitere Informationen finden Sie unter der ODBC-API-Funktion SQLBindCol in der ODBC SDK Programmer's Reference.
nMaxLength
Die maximal zulässige Länge von Werten, die im Array gespeichert wurden, der sich von prgByteVals.Um sicherzustellen, dass die Daten nicht abgeschnitten werden, übergeben Sie einen Wert, der das größte ausreichend groß ist, um das Datenelement aufzunehmen.

Hinweise

Die Spalte darf keinen SQL_BINARY ODBC-Typ Datenquellen, SQL_VARBINARY oder SQL_LONGVARBINARY haben.Das Recordset muss einen Felddatenmember vom Typ pointer BYTE zu definieren.

Wenn Sie prgByteVals und prgLengthsNULL zu initialisieren, werden die Arrays, die sie zu verweisen, automatisch mit Größen gleich der Größe des Rowsets zugeordnet.

Hinweis
den Sammel-Datensatzfeldaustausch überträgt lediglich Daten aus der Datenquelle in das Recordset-Objekt.Um das Recordset aktualisierbar zu machen, müssen Sie die ODBC-API-Funktion SQLSetPos verwenden.