RFX_Binary_Bulk

2013-02-25

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.