void RFX_Binary_Bulk (CFieldExchange * pFX, LPCTSTR szName, BYTE ** prgByteVals, long ** prgLengths, int nMaxLength );
Parâmetros
pFX
Um ponteiro para um objeto CFieldExchange . Este objeto contém informações para definir o contexto de cada chamada da função. Para obter mais informações, consulte o artigo registro de campo Exchange: Como RFX funciona no Guia do programador do Visual C++.
szName
O nome de uma coluna de dados.
prgByteVals
Um ponteiro para uma matriz de valores BYTE . Essa matriz armazenará os dados a ser transferido da fonte de dados para o conjunto de registros.
prgLengths
Um ponteiro para uma matriz de inteiros longos. Essa matriz armazenará o ComComprimento em bytes de cada valor na matriz apontada pelo prgByteVals. Observe que o valor SQL_NULL_DATA será armazenado se o item de dados correspondente contiver um valor nulo. Para obter mais detalhes, consulte a função de API de ODBC SQLBindCol na Referência do programador ODBC SDK.
nMaxLength
O máximo permitido de comprimento dos valores armazenados na matriz apontada pelo prgByteVals. Para garantir que os dados não serão truncados, passe um valor grande o suficiente para acomodar o maior item de dados você espera.
Observações
A função RFX_Binary_Bulk transfere Múltiplo linhas de dados de byte de uma coluna de dados um ODBC Origem para uma correspondente matriz em um CRecordset-derivado objeto. A fonte de dados coluna pode ter um tipo ODBC de SQL_BINARY, SQL_VARBINARYou SQL_LONGVARBINARY. O conjunto de registros deve definir um membro de dados de campo do tipo ponteiro para BYTE.
Se você inicializar prgByteVals e prgLengths a NULL, em seguida, as matrizes que apontam para serão ser alocadas automaticamente, com tamanhos igual ao tamanho conjunto de registros.
&Notanbsp; Troca de campo de registro em massa só transfere dados a origem de dados para o objeto recordset. Para tornar seu recordset atualizável, você deve usar a função de API de ODBC SQLSetPos. Para obter um exemplo de como fazer isso, consulte o exemplo de DBFETCH.
Para obter mais informações, consulte os artigos Recordset: Buscar registros em massa (ODBC) e Registro campo Exchange (RFX) no Guia do programador do Visual C++.
Exemplo
Consulte RFX_Text_Bulk.
Co&nsulte tambémnbsp;RFX_Bool_Bulk, RFX_Byte_Bulk, RFX_Date_Bulk, RFX_Double_Bulk, RFX_Int_Bulk, RFX_Long_Bulk, RFX_Single_Bulk, RFX_Text_Bulk, CFieldExchange:: SetFieldType