IBCPSession::BCPReadFmt(OLE DB)

적용 대상: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform 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)
대량 복사 작업 수행