SQLRowCount

A következőkre vonatkozik:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Amikor paraméterértékek tömbjei kötöttek utasításvégrehajtásra, az SQLRowCount SQL_ERROR értéket ad vissza, ha bármely paramétersor hibafeltételt generál az utasításvégrehajtásban. A függvény RowCountPtr argumentumán keresztül nem tér vissza érték.

Az alkalmazás kihasználhatja a SQL_ATTR_PARAMS_PROCESSED_PTR állítás attribútumot, hogy rögzítse a hiba előtti feldolgozott paraméterek számát.

Továbbá az alkalmazás használhat egy státuszértékekből álló tömböt, amelyet a SQL_ATTR_PARAM_STATUS_PTR utasítás attribútumával köt, hogy rögzítse a sértő paramétersorok tömbeltéreit. Az alkalmazás végigmartassa az állapottömböt a feldolgozott sorok tényleges számának meghatározására.

Amikor egy Transact-SQL INSERT, UPDATE, DELETE, vagy MERGE OUTPUT klauzulával rendelkező utasítást hajtanak végre, az SQLRowCount nem adja vissza az érintett sorok számát, amíg az eredményhalmaz összes sorát el nem fogyasztják. Ezeknek a soroknak a fogyasztásához hívjuk az SQLFetch vagy SQLFetchScroll neveket. Az SQLResultCols -1 vissza fog adni, amíg az összes eredménysort el nem használjuk. Miután a SQLFetch vagy SQLFetchScroll SQL_NO_DATA visszaad, az alkalmazásnak SQLRowCount-t kell hívnia, hogy meghatározza, hány sor érintett, mielőtt az SQLMoreResults-t hívja a következő eredményhez való átlépéshez.