IBCPSession::BCPColumns(OLE DB)

SQL Server 테이블의 열에 바인딩할 필드 수를 설정합니다.

문법

  
HRESULT BCPColumns(   
DBCOUNTITEMnColumns);  

비고

내부적으로 IBCPSession::BCPColFmt 를 호출하여 필드 데이터의 기본값을 설정합니다. 이러한 기본값은 IBCPSession::BCPInit을 통해 테이블 이름을 지정할 때 공급자가 내부적으로 검색하는 SQL Server 열 정보에서 가져옵니다.

기본값과 다른 사용자 파일 형식을 사용하려는 경우에만 이 메서드를 호출해야 합니다. 기본 사용자 파일 형식에 대한 설명에 대한 자세한 내용은 BCPInit 메서드를 참조하세요.

BCPColumns 메서드를 호출한 후 사용자 파일의 각 열에 대해 BCPColFmt 메서드를 호출하여 사용자 지정 파일 형식을 완전히 정의해야 합니다.

주장들

nColumns[in]
사용자 파일의 총 필드 수입니다. 사용자 파일에서 SQL Server 테이블로 데이터를 대량 복사할 준비를 하고 사용자 파일의 모든 필드를 복사하지 않으려는 경우에도 nColumns 인수를 사용자 파일 필드의 총 수로 설정해야 합니다. 그런 다음 BCPColFmt를 통해 건너뛴 필드를 지정할 수 있습니다.

반환 코드 값

S_OK
메서드가 성공했습니다.

E_FAIL
공급자 관련 오류가 발생했습니다. 자세한 내용은 ISQLServerErrorInfo 인터페이스를 사용합니다.

E_UNEXPECTED
메서드 호출이 예기치 않은 경우 예를 들어 BCPInit 메서드는 이 메서드를 호출하기 전에 호출되지 않았습니다. 대량 복사 작업을 위해 이 메서드를 두 번 이상 호출할 때도 발생합니다.

E_OUTOFMEMORY (메모리 부족 오류)
메모리 부족 오류입니다.

또한 참조하십시오

IBCPSession(OLE DB)
대량 복사 작업 수행