SQLRowCount

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體Azure Synapse AnalyticsAnalytics Platform System (PDW)

當參數值的陣列系結到語句執行時，如果任何參數值的資料列在語句執行中產生錯誤條件， SQLRowCount 就會傳回SQL_ERROR。 不會透過 函式的 RowCountPtr 引數傳回任何值。

應用程式可以利用 SQL_ATTR_PARAMS_PROCESSED_PTR 語句屬性來擷取錯誤發生前處理的參數數目。

此外，應用程式可以使用狀態值的陣列，藉由使用 SQL_ATTR_PARAM_STATUS_PTR 語句屬性來擷取違規參數資料列的陣列位移。 應用程式可以周遊狀態陣列，以判斷處理的實際資料列數目。

執行具有 OUTPUT 子句的 Transact-SQL INSERT、UPDATE、DELETE 或 MERGE 語句時，除非取用 OUTPUT 子句所產生的結果集中所有資料列，否則 SQLRowCount 將不會傳回受影響的資料列計數。 若要取用這些資料列，您可以呼叫 SQLFetch 或 SQLFetchScroll。 SQLResultCols 會傳回 -1，直到取用所有結果資料列為止。 在 SQLFetch 或 SQLFetchScroll 傳回SQL_NO_DATA之後，應用程式必須呼叫 SQLRowCount，以判斷在呼叫 SQLMoreResults 之前受影響的資料列數目，才能移至下一個結果。

另請參閱

SQLRowCount 函式
ODBC API 實作詳細資料