커서 사용(ODBC)
커서를 사용하려면
SQLSetStmtAttr을 호출하여 원하는 커서 특성을 설정합니다.
SQL_ATTR_CURSOR_TYPE 및 SQL_ATTR_CONCURRENCY 특성을 설정합니다(기본 옵션).
또는
SQL_CURSOR_SCROLLABLE 및 SQL_CURSOR_SENSITIVITY 특성을 설정합니다.
SQLSetStmtAttr을 호출하여 SQL_ATTR_ROW_ARRAY_SIZE 특성으로 행 집합 크기를 설정합니다.
필요한 경우 WHERE CURRENT OF 절을 사용하여 위치 지정 업데이트를 수행하려면 SQLSetCursorName을 호출하여 커서 이름을 설정합니다.
SQL 문을 실행합니다.
필요한 경우 WHERE CURRENT OF 절을 사용하여 위치 지정 업데이트를 수행하려면 SQLGetCursorName을 호출하여 커서 이름을 가져옵니다(3단계에서 SQLSetCursorName을 사용하여 커서 이름을 지정하지 않은 경우).
SQLNumResultCols를 호출하여 행 집합의 열 수(C)를 가져옵니다.
열 단위 바인딩을 사용합니다.
- 또는 -
행 단위 바인딩을 사용합니다.
커서에서 원하는 대로 행 집합을 인출합니다.
SQLMoreResults를 호출하여 다른 결과 집합이 있는지 확인합니다.
다른 결과 집합이 있으면 SQL_SUCCESS가 반환됩니다.
다른 결과 집합이 없으면 SQL_NO_DATA가 반환됩니다.
SQL_SUCCESS_WITH_INFO 또는 SQL_ERROR가 반환되면 SQLGetDiagRec를 호출하여 사용할 수 있는 PRINT 또는 RAISERROR 문 출력이 있는지 확인합니다.
바인딩된 문 매개 변수가 출력 매개 변수 또는 저장 프로시저의 반환 값으로 사용될 경우 바인딩된 매개 변수 버퍼에서 현재 사용할 수 있는 데이터를 사용합니다.
바인딩된 매개 변수를 사용하면 SQLExecute 또는 SQLExecDirect를 호출할 때마다 SQL 문이 S번 실행됩니다. 여기서 S는 바인딩된 매개 변수 배열에 포함된 요소 수입니다. 이는 S개의 결과 집합을 처리해야 함을 의미하며, 각 결과 집합은 SQL 문을 한 번 실행했을 때 일반적으로 반환되는 모든 결과 집합, 출력 매개 변수 및 반환 코드 전체로 구성됩니다.
결과 집합에 계산 행이 포함된 경우 각 계산 행은 별도의 결과 집합으로 사용할 수 있습니다. 이러한 계산 결과 집합은 일반 행 내에 섞여 일반 행을 여러 개의 결과 집합으로 나눕니다.
필요에 따라 SQL_UNBIND와 함께 SQLFreeStmt를 호출하여 바인딩된 열 버퍼를 해제합니다.
다른 결과 집합이 있으면 6단계부터 반복합니다.
9단계에서 부분적으로 처리된 결과 집합에 대해 SQLMoreResults를 호출하면 나머지 결과 집합이 지워집니다. SQLCloseCursor를 호출하여 부분적으로 처리된 결과 집합을 지울 수도 있습니다.
SQL_ATTR_CURSOR_TYPE 및 SQL_ATTR_CONCURRENCY를 설정하거나 SQL_ATTR_CURSOR_SENSITIVITY 및 SQL_ATTR_CURSOR_SCROLLABLE을 설정하여 사용되는 커서 유형을 제어할 수 있습니다. 커서 동작을 지정할 때 이 두 방법을 함께 사용하면 안 됩니다.