IBCPSession::BCPWriteFmt(OLE DB)

각 열의 형식 정보를 서식 파일에 기록합니다.

구문

HRESULT BCPWriteFmt( 
      const wchar_t *pwszFormatFile);

주의

서식 파일은 대량 복사를 통해 만들어진 데이터 파일의 데이터 형식을 지정합니다. IBCPSession::BCPColumnsIBCPSession::BCPColFmt 메서드를 호출하여 데이터 파일의 형식을 정의합니다. BCPWriteFmt 메서드는 이 정의를 pwszFormatFile 인수에서 참조하는 파일에 저장합니다.

BCPWriteFmt 메서드는 서식 파일을 xml 또는 text 형식으로 저장할 수 있습니다. IBCPSession::BCPControl 메서드에 BCP_OPTION_XML 제어 옵션을 사용하여 서식 파일의 형식을 나타내야 합니다.

저장된 서식 파일을 로드하려면 IBCPSession::BCPReadFmt 메서드를 사용합니다.

[!참고]

BCPWriteFmt 메서드를 통해 생성된 서식 파일은 SQL Server 버전 7.0 이상과 함께 배포된 bcp 유틸리티 버전에서만 지원됩니다.

인수

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

반환 코드 값

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

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

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

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

참고 항목

개념

대량 복사 작업 수행

관련 자료

IBCPSession(OLE DB)