RFX_Binary_Bulk

Článek
06/10/2015

Přenáší více řádků dat byte ze sloupce zdroj dat ODBC na odpovídající pole v CRecordset-odvozené objekt.

void RFX_Binary_Bulk( 
   CFieldExchange* pFX, 
   LPCTSTR szName, 
   BYTE** prgByteVals, 
   long** prgLengths, 
   int nMaxLength  
);

Parametry

pFX
Určuje ukazatel na objekt CFieldExchange.Tento objekt obsahuje informace, které definují kontext pro každé volání funkce.Další informace naleznete v článku Výměna pole záznamu: Jak funguje RFX.
szName
Název datového sloupce.
prgByteVals
Ukazatel na pole BAJT hodnoty.Toto pole bude ukládat data převést ze zdroje dat do sady záznamů.
prgLengths
Ukazatel na pole dlouhých celých čísel.Toto pole bude ukládat délka v bajtech všechny hodnoty v poli, na kterou odkazuje prgByteVals.Všimněte si, že hodnota SQL_NULL_DATA budou uloženy, pokud odpovídající položka dat obsahuje hodnotu Null.Další informace naleznete v tématu funkce rozhraní ODBC API SQLBindCol v ODBC SDK Programmer's Reference.
nMaxLength
Maximální povolená délka hodnot uložených v poli, na kterou odkazuje prgByteVals.Chcete-li zajistit, že data nebudou zkráceny, předáte hodnotu dostatečně velká k pokrytí největší datové položky, které očekáváte.

Poznámky

Zdrojový sloupec dat může mít ODBC typ SQL_BINARY, SQL_VARBINARY, nebo SQL_LONGVARBINARY.Definovat typ ukazatele na pole datových členů sady záznamů BAJT.

Pokud můžete inicializovat prgByteVals a prgLengths k NULL, pak pole odkazují bude přiděleno automaticky, jejichž velikost se rovná velikosti sady řádků.

[!POZNÁMKA]

Hromadná výměna pole záznamu pouze přenáší data ze zdroje dat do objektu sady záznamů.Aby vaše sada záznamů aktualizovatelná, musíte použít funkci rozhraní ODBC API SQLSetPos.

Další informace naleznete v článcích sady záznamů: Fetching Records in Bulk (ODBC) a Výměna pole záznamu (RFX).