RFX_Byte_Bulk

Artigo
02/25/2013

Transfere várias linhas de único bytes de uma coluna de uma fonte de dados ODBC para uma matriz correspondente em um CRecordset-derivado objeto.

void RFX_Byte_Bulk(
   CFieldExchange* pFX,
   LPCTSTR szName,
   BYTE** prgByteVals,
   long** prgLengths 
);

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.

Comentários

Coluna da fonte de dados deve ter um tipo ODBC de SQL_TINYINT.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.