RFX_Binary_Bulk

Artigo
08/25/2010

Transfere várias linhas de dados de byte de uma coluna de uma fonte de dados ODBC a uma matriz correspondente em um CRecordset-derivados do 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 para cada telefonar da função.Para obter mais informações, consulte o artigo Intercâmbio de campo do registro: Como RFX trabalha.
szName
O nome de uma coluna de dados.
prgByteVals
Um ponteiro para uma matriz de BYTE valores.Essa matriz irá armazenar os dados devem ser transferidos da fonte de dados para o 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 por prgByteVals. Observe que o valor SQL_NULL_DATA serão armazenados se o item de dados correspondente contiver um valor nulo.Para obter mais detalhes, consulte a função de ODBC API SQLBindCol in the Referência do programador de ODBC SDK.
nMaxLength
O comprimento máximo permitido dos valores armazenados na matriz apontada por 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, or SQL_LONGVARBINARY.O conjunto de registros deve definir um membro de dados de campo do tipo de ponteiro para BYTE.

Se você inicializar prgByteVals e prgLengths para NULO, em seguida, os arrays que apontem para será alocado automaticamente, com tamanhos igual ao dimensionar do conjunto de linhas.

Observação:
Troca de campo de registro em massa só transfere dados da fonte de dados para o objeto de conjunto de registros.Para tornar seu conjunto de registros atualizável, você deve usar a função de ODBC API SQLSetPos.