SQLRowCount 함수

규칙
버전 소개: ODBC 1.0 표준 준수: ISO 92

요약
SQLRowCount는 UPDATE, INSERT 또는 DELETE 문의 영향을 받는 행 수, SQLBulkOperations의 SQL_ADD, SQL_UPDATE_BY_BOOKMARK 또는 SQL_DELETE_BY_BOOKMARK 작업 또는 SQLSetPos의 SQL_UPDATE 또는 SQL_DELETE 작업을 반환합니다.

구문

  
SQLRETURN SQLRowCount(  
      SQLHSTMT   StatementHandle,  
      SQLLEN *   RowCountPtr);  

인수

StatementHandle
[입력] 문 핸들입니다.

RowCountPtr
[출력] 행 수를 반환할 버퍼를 가리킵니다. UPDATE, INSERT 및 DELETE 문, SQLBulkOperations의 SQL_ADD, SQL_UPDATE_BY_BOOKMARK 및 SQL_DELETE_BY_BOOKMARK 작업 및 SQLSetPos의 SQL_UPDATE 또는 SQL_DELETE 작업의 경우 *RowCountPtr에서 반환되는 값은 요청의 영향을 받는 행 수이거나 영향을 받는 행 수를 사용할 수 없는 경우 -1입니다.

SQLExecute, SQLExecDirect, SQLBulkOperations, SQLSetPos 또는 SQLMoreResults가 호출되면 진단 데이터 구조의 SQL_DIAG_ROW_COUNT 필드가 행 수로 설정되고 행 수가 구현에 종속된 방식으로 캐시됩니다. SQLRowCount 는 캐시된 행 개수 값을 반환합니다. 캐시된 행 개수 값은 문 핸들이 준비되거나 할당된 상태로 다시 설정되거나 문이 다시 검사되거나 SQLCloseCursor 가 호출될 때까지 유효합니다. SQL_DIAG_ROW_COUNT 필드가 설정된 이후 함수가 호출된 경우 함수 호출에 의해 SQL_DIAG_ROW_COUNT 필드가 0으로 다시 설정되므로 SQLRowCount 에서 반환되는 값이 SQL_DIAG_ROW_COUNT 필드의 값과 다를 수 있습니다.

다른 문 및 함수의 경우 드라이버는 *RowCountPtr에서 반환된 값을 정의할 수 있습니다. 예를 들어 일부 데이터 원본은 행을 가져오기 전에 SELECT 문 또는 카탈로그 함수에서 반환하는 행 수를 반환할 수 있습니다.

참고 항목

많은 데이터 원본은 가져오기 전에 결과 집합의 행 수를 반환할 수 없습니다. 최대 상호 운용성을 위해 애플리케이션은 이 동작에 의존해서는 안 됩니다.

반품

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR 또는 SQL_INVALID_HANDLE.

진단

SQLRowCount가 SQL_ERROR 또는 SQL_SUCCESS_WITH_INFO 반환하는 경우 SQL_HANDLE_STMT HandleType 및Handle of StatementHandle을 사용하여 SQLGetDiagRec 를 호출하여 관련 SQLSTATE 값을 가져올 수 있습니다. 다음 표에서는 SQLRowCount에서 일반적으로 반환되는 SQLSTATE 값을 나열하고 이 함수의 컨텍스트에서 각각에 대해 설명합니다. "(DM)" 표기법은 드라이버 관리자가 반환한 SQLSTATE에 대한 설명 앞에 나와 있습니다. 달리 명시되지 않는 한 각 SQLSTATE 값과 연결된 반환 코드는 SQL_ERROR.

SQLSTATE	Error	설명
01000	일반 경고	드라이버 관련 정보 메시지입니다. 함수는 SQL_SUCCESS_WITH_INFO 반환합니다.
HY000	일반 오류	특정 SQLSTATE가 없고 구현별 SQLSTATE가 정의되지 않은 오류가 발생했습니다. *MessageText 버퍼의 SQLGetDiagRec에서 반환된 오류 메시지는 오류와 그 원인을 설명합니다.
HY001	메모리 할당 오류	드라이버가 함수 실행 또는 완료를 지원하는 데 필요한 메모리를 할당할 수 없습니다.
HY010	함수 시퀀스 오류	(DM) StatementHandle과 연결된 연결 핸들에 대해 비동기적으로 실행되는 함수가 호출되었습니다. 이 비동기 함수는 SQLRowCount 함수가 호출되었을 때 계속 실행되었습니다. (DM) SQLExecute, SQLExecDirect 또는 SQLMoreResults가 StatementHandle에 대해 호출되고 SQL_PARAM_DATA_AVAILABLE 반환되었습니다. 이 함수는 모든 스트리밍된 매개 변수에 대해 데이터를 검색하기 전에 호출되었습니다. (DM) 이 함수는 StatementHandle에 대해 SQLExecute, SQLExecDirect, SQLBulkOperations 또는 SQLSetPos를 호출하기 전에 호출되었습니다. (DM) StatementHandle에 대해 비동기적으로 실행되는 함수가 호출되었고 이 함수가 호출되었을 때에도 여전히 실행 중입니다. (DM) SQLExecute, SQLExecDirect, SQLBulkOperations 또는 SQLSetPos가 StatementHandle에 대해 호출되고 SQL_NEED_DATA 반환되었습니다. 이 함수는 모든 실행 시 데이터 매개 변수 또는 열에 대한 데이터를 보내기 전에 호출되었습니다.
HY013	메모리 관리 오류	메모리 조건이 낮기 때문에 기본 메모리 개체에 액세스할 수 없기 때문에 함수 호출을 처리할 수 없습니다.
HY117	알 수 없는 트랜잭션 상태로 인해 연결이 일시 중단됩니다. 연결 끊기 및 읽기 전용 함수만 허용됩니다.	(DM) 일시 중단 상태에 대한 자세한 내용은 SQLEndTran 함수를 참조 하세요.
HYT01	연결 제한 시간이 만료됨	데이터 원본이 요청에 응답하기 전에 연결 제한 시간이 만료되었습니다. 연결 제한 시간은 SQL_ATTR_CONNECTION_TIMEOUT SQLSetConnectAttr를 통해 설정됩니다.
IM001	드라이버는 이 함수를 지원하지 않습니다.	(DM) StatementHandle과 연결된 드라이버는 함수를 지원하지 않습니다.

주석

문 핸들에서 실행된 마지막 SQL 문이 UPDATE, INSERT 또는 DELETE 문이 아니거나 SQLBulkOperations에 대한 이전 호출의 Operation 인수가 SQL_ADD, SQL_UPDATE_BY_BOOKMARK 또는 SQL_DELETE_BY_BOOKMARK 아닌 경우 또는 SQLSetPos에 대한 이전 호출의 Operation 인수가 SQL_UPDATE 또는 SQL_DELETE 않은 경우 *RowCountPtr 값은 드라이버 정의입니다. 자세한 내용은 영향을 받는 행 수 확인 을 참조 하세요.

관련 함수

추가 정보	참조
SQL 문 실행	SQLExecDirect 함수
준비된 SQL 문 실행	SQLExecute 함수

참고 항목

ODBC API 참조
ODBC 헤더 파일