RFX_Binary_Bulk
Transfere várias linhas de dados byte de uma coluna de uma fonte de dados ODBC para uma matriz correspondente em um CRecordset-derivado objeto.
void RFX_Binary_Bulk(
CFieldExchange* pFX,
LPCTSTR szName,
BYTE** prgByteVals,
long** prgLengths,
int nMaxLength
);
Parâmetros
pFX
Um ponteiro para um CFieldExchange objeto.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 funciona RFX.szName
O nome de uma coluna de dados.prgByteVals
Um ponteiro para uma matriz de bytes valores.Essa matriz armazenará os dados a ser transferido da fonte de dados ao conjunto de registros.prgLengths
Um ponteiro para uma matriz de inteiros longos.Essa matriz armazenará o comprimento 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 ODBC SQLBindCol na referência do programador de ODBC SDK.nMaxLength
O número máximo permitido de comprimento dos valores armazenados na matriz apontada pelo prgByteVals.Para garantir que dados não serão truncados, passe um valor grande o suficiente para acomodar o item de dados maior que o esperado.
Comentários
Coluna da fonte de dados pode ter um tipo ODBC de SQL_BINARY, SQL_VARBINARY, ou SQL_LONGVARBINARY.O conjunto de registros deve definir um membro de dados de campo de ponteiro de tipo para bytes.
Se você inicializar prgByteVals e prgLengths para Nulo, em seguida, as matrizes que eles apontam para serão alocadas automaticamente, com tamanhos iguais ao tamanho do conjunto de linhas.
Observação |
---|
Exchange de campo de registro em massa só transfere dados da fonte de dados para o objeto recordset.Para tornar seu recordset atualizável, você deve usar a função de API ODBC SQLSetPos. |
Para obter mais informações, consulte os artigos Recordset: buscar registros em massa (ODBC) e Registro campo Exchange (RFX).
Exemplo
Consulte RFX_Text_Bulk.
Requisitos
Cabeçalho: afxdb.h