다음을 통해 공유


SQLGetData(커서 라이브러리)

Important

이 기능은 이후 Windows 버전에서 제공될 예정입니다. 새 개발 작업에서 이 기능을 사용하지 말고 현재 이 기능을 사용하는 애플리케이션을 수정할 계획입니다. 드라이버의 커서 기능을 사용하는 것이 좋습니다.

이 항목에서는 커서 라이브러리에서 SQLGetData 함수의 사용에 대해 설명합니다. SQLGetData에 대한 일반적인 내용은 SQLGetData 함수를 참조하세요.

커서 라이브러리는 먼저 현재 행의 각 바인딩된 열에 대해 캐시에 저장된 값을 열거하는 WHERE 절을 사용하여 SELECT 문을 생성하여 SQLGetData를 구현합니다. 그런 다음 SELECT 문을 실행하여 행을 다시 선택하고 드라이버에서 SQLGetData를 호출하여 캐시가 아닌 데이터 원본에서 데이터를 검색합니다.

주의

현재 행을 식별하기 위해 커서 라이브러리에서 생성된 WHERE 절은 행을 식별하거나 다른 행을 식별하거나 둘 이상의 행을 식별하지 못할 수 있습니다. 자세한 내용은 검색된 문 생성을 참조 하세요.

SQL_ATTR_USE_BOOKMARKS 문 특성이 SQL_UB_VARIABLE 설정된 경우 0열에서 SQLGetData 를 호출하여 책갈피 데이터를 반환할 수 있습니다.

SQLGetData대한 호출에는 다음과 같은 제한 사항이 적용됩니다.

  • SQLGetData 는 정방향 전용 커서에 대해 호출할 수 없습니다.

  • SQLGetData는 다음 조건이 충족될 때만 호출할 수 있습니다. SELECT 문은 결과 집합을 생성하고 SELECT 문은 조인, UNION 절 또는 GROUP BY 절을 포함하지 않았으며 선택 목록에서 별칭 또는 식을 사용한 열은 SQLBindCol바인딩되지 않았습니다.

  • 드라이버가 하나의 활성 문만 지원하는 경우 커서 라이브러리는 SELECT 문을 실행하고 SQLGetData호출하기 전에 나머지 결과 집합을 가져옵니다.