다음을 통해 공유


SQLRowCount

문 실행을 위해 매개 변수 값의 배열을 바인딩한 경우 문 실행 시 매개 변수 값의 행 중 하나라도 오류 조건을 생성하면 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를 반환한 후 응용 프로그램에서는 SQLMoreResults를 호출하여 다음 결과로 이동하기 전에 SQLRowCount를 호출하여 영향을 받는 행 수를 확인해야 합니다.