IBCPSession::BCPReadFmt(OLE DB)

적용 대상: SQL Server Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

OLE DB 드라이버 다운로드

서식 파일에서 각 열의 서식 정보를 읽습니다.

구문

  
HRESULT BCPReadFmt(   
      const wchar_t *pwszFormatFile);  

설명

BCPReadFmt 메서드는 데이터 파일의 데이터 형식을 지정하는 서식 파일에서 데이터를 읽을 때 사용됩니다. 이 메서드는 서식 파일의 올바른 버전을 검색할 수 있으므로 서식 파일이 xml인지 이전 스타일의 텍스트 형식인지 자동으로 검색하여 그에 따라 동작합니다. OLE DB Driver for SQL Server BCP가 지원하는 서식 파일 버전은 버전 6.0 이상입니다.

BCPReadFmt 메서드는 형식 값을 읽은 후 IBCPSession::BCPColumns 및 IBCPSession::BCPColFmt 메서드를 적절히 호출합니다. 따라서 사용자가 서식 파일의 구문을 분석하여 메서드를 호출할 필요가 없습니다.

서식 파일을 저장하려면 IBCPSession::BCPWriteFmt 메서드를 호출합니다. BCPReadFmt 메서드를 호출할 때 저장된 형식을 참조할 수 있습니다. 또한 대량 복사 유틸리티(bcp)로 사용자 정의 데이터 형식을 BCPReadFmt 메서드가 참조할 수 있는 파일에 저장할 수 있습니다.

IBCPSession::BCPControl의 eOption 매개 변수에 대한 BCP_OPTION_DELAYREADFMT 값은 IBCPSession::BCPReadFmt 동작을 수정합니다.

인수

pwszFormatFile[in]
데이터 파일에 대한 형식 값이 포함된 파일의 경로 및 파일 이름입니다.

반환 코드 값

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

E_FAIL
공급자 관련 오류가 발생했습니다. 자세한 내용을 보려면 ISQLServerErrorInfo 인터페이스를 사용하세요.

E_OUTOFMEMORY
메모리 부족 오류가 발생했습니다.

E_UNEXPECTED
예기치 않은 메서드가 호출되었습니다. 예를 들어 이 메서드를 호출하기 전에 IBCPSession::BCPInit 메서드를 호출하지 않았습니다.

참고 항목

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