IBCPSession::BCPWriteFmt(Native Client OLE DB Provider)

  • 아티클

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

Important

SQL Server Native Client(약칭 SNAC)는 SQL Server 2022(16.x) 및 SSMS(SQL Server Management Studio) 19에서 제거되었습니다. SQL Server Native Client OLE DB 공급자(SQLNCLI 또는 SQLNCLI11)와 레거시 Microsoft OLE DB Provider for SQL Server(SQLOLEDB)는 모두 새로운 개발에 권장되지 않습니다. 앞으로 SQL Server용 새 Microsoft OLE DB 드라이버(MSOLEDBSQL)로 전환합니다.

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

구문

  
HRESULT BCPWriteFmt(   
      const wchar_t *pwszFormatFile);

설명

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

BCPWriteFmt 메서드는 서식 파일을 xml 또는 텍스트 형식으로 저장할 수 있습니다. IBCPSession::BCPControl 메서드와 함께 BCP_OPTION_XML 컨트롤 옵션을 사용하여 표시해야 합니다.

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

인수

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

반환 코드 값

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

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

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

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

참고 항목

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