RFX_Binary_Bulk

Articolo
06/10/2015

Trasferisce le righe di dati byte da una colonna di un'origine dati ODBC a una matrice corrispondente in CRecordset- oggetto derivato.

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

Parametri

pFX
Un puntatore a un oggetto CFieldExchange. Questo oggetto contiene le informazioni per definire il contesto per ogni chiamata della funzione. Per ulteriori informazioni, vedere l'articolo Trasferimento di campi di Record: Funzionamento di RFX.
szName
Il nome di una colonna di dati.
prgByteVals
Un puntatore a una matrice di valori di BYTE. Questa matrice verranno archiviati i dati da trasferire dall'origine dati al recordset.
prgLengths
Un puntatore a una matrice di integer long. Questa matrice archivierà la lunghezza in byte di ogni valore nella matrice indicata da prgByteVals. Si noti che il valore SQL_NULL_DATA verrà archiviato se l'elemento dati corrispondente contiene un valore null. Per ulteriori informazioni, vedere la funzione API ODBC SQLBindColin ODBC SDK programmer's reference.
nMaxLength
La lunghezza massima consentita dei valori memorizzati nella matrice indicato da prgByteVals. Per assicurarsi che i dati non verranno troncati, passare un valore abbastanza grande da contenere il più grande elemento di dati come previsto.

Note

La colonna di origine dati può avere un tipo di ODBC SQL_BINARY, di SQL_VARBINARY, o di SQL_LONGVARBINARY. Il recordset deve definire un membro dati di campo di tipo puntatore a BYTE.

Se si inizializza prgByteVals e prgLengths a NULL, le matrici che indicano vengono allocate automaticamente, le cui dimensioni uguale alla dimensione del rowset.

Nota

Il trasferimento di massa di campi di Record trasferita solo i dati da un'origine dati all'oggetto recordset.Per rendere il recordset aggiornabile, è necessario utilizzare la funzione API ODBC SQLSetPos.

Per ulteriori informazioni, vedere gli articoli Recordset: Recupero di massa di record (ODBC) e Trasferimento di campi di Record.