SQLRowCount
適用於: SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics 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 之前受影響的數據列數目,才能移至下一個結果。