Sdílet prostřednictvím


Pole stavu řádku

Kromě dat může sqlFetch a SQLFetchScroll vrátit pole, které dává stav každého řádku v sadě řádků. Toto pole je určeno prostřednictvím atributu příkazu SQL_ATTR_ROW_STATUS_PTR. Toto pole je přiděleno aplikací a musí mít tolik prvků, kolik jsou určeny atributem SQL_ATTR_ROW_ARRAY_SIZE příkazu. Hodnoty v poli jsou nastaveny sqlBulkOperations, SQLFetch, SQLFetchScroll a SQLSetPos. Hodnoty popisují stav řádku a informace o tom, jestli se tento stav od posledního načtení změnil.

Hodnota pole pro stav řádku Description
SQL_ROW_SUCCESS Řádek byl úspěšně načten a od posledního načtení se nezměnil.
SQL_ROW_SUCCESS_WITH_INFO Řádek byl úspěšně načten a od posledního načtení se nezměnil. Avšak bylo vráceno upozornění o řádku.
SQL_ROW_ERROR Při načítání řádku došlo k chybě.
SQL_ZÁZNAM_AKTUALIZOVÁN Řádek byl úspěšně načten a byl aktualizován od posledního načtení. Pokud se řádek znovu načte nebo aktualizuje službou SQLSetPos, změní se jeho stav na nový stav.

Některé ovladače nemohou rozpoznat změny dat, a proto nemohou tuto hodnotu vrátit. Chcete-li zjistit, zda ovladač může rozpoznat aktualizace pro opětovné načtení řádků, aplikace volá SQLGetInfo s možností SQL_ROW_UPDATES.
SQL_ROW_DELETED Řádek byl odstraněn od posledního načtení.
SQL_ROW_ADDED Řádek byl vložen prostřednictvím SQLBulkOperations. Pokud se řádek znovu načte nebo se aktualizuje službou SQLSetPos, její stav se SQL_ROW_SUCCESS.

Tato hodnota není nastavena sqlFetch nebo SQLFetchScroll.
SQL_ROW_NOROW Sada řádků překrývala konec sady výsledků a nebyl vrácen žádný řádek, který odpovídá tomuto prvku pole stavu řádku.