SQLRowCount

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

매개 변수 값의 배열이 문 실행에 바인딩되면 SQLRowCount는 매개 변수 값 행이 문 실행에서 오류 조건을 생성하는 경우 SQL_ERROR 반환합니다. 함수의 RowCountPtr 인수를 통해 값이 반환되지 않습니다.

애플리케이션에서는 SQL_ATTR_PARAMS_PROCESSED_PTR 매개 변수 특성을 사용하여 오류가 발생하기 전에 처리된 매개 변수 수를 캡처할 수 있습니다.

또한 애플리케이션은 SQL_ATTR_PARAM_STATUS_PTR 문 특성을 사용하여 바인딩된 상태 값 배열을 사용하여 잘못된 매개 변수 행의 배열 오프셋을 캡처할 수 있습니다. 애플리케이션은 상태 배열을 트래버스하여 처리된 행의 실제 수를 확인할 수 있습니다.

OUTPUT 절이 있는 Transact-SQL INSERT, UPDATE, DELETE 또는 MERGE 문이 실행되면 SQLRowCount는 OUTPUT 절에서 생성된 결과 집합의 모든 행이 소비될 때까지 영향을 받는 행 수를 반환하지 않습니다. 이러한 행을 사용하려면 SQLFetch 또는 SQLFetchScroll을 호출합니다. SQLResultCols는 모든 결과 행을 사용할 때까지 -1을 반환합니다. SQLFetch 또는 SQLFetchScroll이 SQL_NO_DATA 반환한 후 애플리케이션은 SQLMoreResults를 호출하여 다음 결과로 이동하기 전에 영향을 받는 행 수를 확인하기 위해 SQLRowCount를 호출해야 합니다.

참고 항목

SQLRowCount 함수
ODBC API 구현 정보