SQLRowCount

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytický platformní systém (PDW)

Když jsou pole parametrů omezena pro provádění příkazů, SQLRowCount vrací SQL_ERROR, pokud jakýkoli řádek parametrů generuje chybový stav při provádění příkazu. Přes argument RowCountPtr funkce není vrácena žádná hodnota.

Aplikace může využít atribut SQL_ATTR_PARAMS_PROCESSED_PTR příkazu k zachycení počtu parametrů zpracovaných před vznikem chyby.

Dále může aplikace použít pole stavových hodnot, omezené pomocí atributu SQL_ATTR_PARAM_STATUS_PTR, k zachycení posunů pole řádků problematických parametrů. Aplikace může procházet stavové pole a určit skutečný počet zpracovaných řádků.

Když je vykonán Transact-SQL INSERT, UPDATE, DELETE, nebo MERGE příkaz s klauzulí OUTPUT, SQLRowCount nevrátí počet ovlivněných řádků, dokud nebudou všechny řádky v množině výsledků generované klauzulí OUTPUT spotřebovány. Pro zpracování těchto řádků voláte SQLFetch nebo SQLFetchScroll. SQLResultCols bude vracet -1, dokud nebudou všechny řádky výsledků spotřebovány. Po vrácení SQL_NO_DATA SQLFetch nebo SQLFetchScroll musí aplikace zavolat SQLRowCount, aby určila počet ovlivněných řádků, než zavolá SQLMoreResults pro přechod na další výsledek.

Viz také

Funkce SQLRowCount
Podrobnosti implementace rozhraní ODBC API