bcp_collen

현재 대량 복사에 대한 프로그램 변수의 데이터 길이를 SQL Server로 설정합니다.

구문

RETCODE bcp_collen (
        HDBC hdbc,
        DBINT cbData,
        INT idxServerCol);

인수

• hdbc
  대량 복사가 가능한 ODBC 연결 핸들입니다.

• cbData
  길이 표시기나 종결자의 길이를 제외한 프로그램 변수의 데이터 길이입니다. cbData를 SQL_NULL_DATA로 설정하면 열에 NULL 값이 있는 모든 행이 서버로 복사됩니다. SQL_VARLEN_DATA로 설정하면 복사되는 데이터의 길이를 확인하는 데 문자열 종결자 또는 다른 메서드가 사용됩니다. 길이 표시기와 종결자가 모두 있으면 시스템에서는 복사되는 데이터 크기가 더 작은 것이 사용됩니다.

• idxServerCol
  데이터가 복사되는 대상 테이블 열의 서수 위치입니다. 첫 번째 열은 1입니다. 열의 서수 위치는 SQLColumns를 사용하여 확인할 수 있습니다.

반환 값

SUCCEED 또는 FAIL

주의

bcp_collen 함수를 사용하면 bcp_sendrow를 통해 데이터를 SQL Server로 복사할 때 특정 열의 프로그램 변수에 있는 데이터 길이를 변경할 수 있습니다.

처음에는 bcp_bind를 호출할 때 데이터 길이가 확인됩니다. bcp_sendrow 호출 간에 데이터 길이가 변경되고 길이 접두사 또는 종결자가 사용되지 않는 경우 bcp_collen을 호출하여 길이를 다시 설정할 수 있습니다. 다음에 bcp_sendrow를 호출하면 bcp_collen 호출을 통해 설정된 길이가 사용됩니다.

테이블에서 데이터 길이를 수정할 각 열에 대해 한 번씩 bcp_collen을 호출해야 합니다.

참고 항목

참조

대량 복사 함수