SQLBindCol(커서 라이브러리)

Important

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

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

애플리케이션은 커서 라이브러리에 대해 하나 이상의 버퍼를 할당하여 현재 행 집합을 반환합니다. SQLBindCol을 한 번 이상 호출하여 이러한 버퍼를 결과 집합에 바인딩합니다.

애플리케이션은 바인딩된 열의 C 데이터 형식, 열 크기 및 소수 자릿수가 동일하게 유지되는 한 SQLExtendedFetch, SQLFetch 또는 SQLFetchScroll을 호출한 후 SQLBindCol을 호출하여 결과 집합 열을 다시 바인딩할 수 있습니다. 애플리케이션은 다른 주소로 열을 다시 바인딩하기 위해 커서를 닫을 필요가 없습니다.

커서 라이브러리는 바인딩 오프셋을 사용하도록 SQL_ATTR_ROW_BIND_OFFSET_PTR 문 특성 설정을 지원합니다. (SQLBindCol을 호출할 필요가 없으므로 이 다시 바인딩이 수행됩니다.) 커서 라이브러리가 ODBC 3.x 드라이버와 함께 사용되는 경우 SQLFetch를 호출할 때 바인딩 오프셋이 사용되지 않습니다. 바인딩 오프셋은 SQLFetch가 SQLExtendedFetch에 매핑되므로 커서 라이브러리를 ODBC 2.x 드라이버와 함께 사용할 때 SQLFetch가 호출되는 경우에 사용됩니다.

커서 라이브러리는 책갈피 열을 바인딩하기 위해 SQLBindCol 호출을 지원합니다.

ODBC 2.x 드라이버로 작업할 때 커서 라이브러리는 책갈피 열의 버퍼 길이를 4가 아닌 값으로 설정하기 위해 SQLBindCol이 호출될 때 SQLSTATE HY090(잘못된 문자열 또는 버퍼 길이)을 반환합니다. ODBC 3.x 드라이버로 작업할 때 커서 라이브러리를 사용하면 버퍼의 크기가 어느 크기든지 사용할 수 있습니다.