IBCPSession::BCPWriteFmt (Native Client OLE DB-leverantör)

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Important

Den interna SQL Server-klienten (ofta förkortad SNAC) har tagits bort från SQL Server 2022 (16.x) och SQL Server Management Studio 19 (SSMS). Både SQL Server Native Client OLE DB-providern (SQLNCLI eller SQLNCLI11) och den äldre Microsoft OLE DB-providern för SQL Server (SQLOLEDB) rekommenderas inte för ny utveckling. Växla till den nya Microsoft OLE DB Driver (MSOLEDBSQL) för SQL Server framöver.

Skriver formatinformation för varje kolumn till formatfilen.

Syntax

  
HRESULT BCPWriteFmt(   
      const wchar_t *pwszFormatFile);  

Remarks

Formatfilen specificerar dataformatet för en datafil som skapas genom masskopiering. Anrop till IBCPSession::BCPColumns och IBCPSession::BCPColFmt-metoderna definierar formatet på datafilen. BCPWriteFmt-metoden sparar denna definition i filen som refereras till av argumentet pwszFormatFile.

BCPWriteFmt-metoden kan spara formatfilerna i antingen xml- eller textformat. Detta måste indikeras genom att använda BCP_OPTION_XML kontrollalternativet med IBCPSession::BCPControl-metoden .

För att ladda en sparad fil, använd metoden IBCPSession::BCPReadFmt .

Arguments

pwszFormatFile[in]
Sökvägen och filnamnet på filen som innehåller formatvärdena för datafilen.

Returnera kodvärden

S_OK
Metoden lyckades.

E_FAIL
Ett providerspecifikt fel uppstod. För detaljerad information använder du gränssnittet ISQLServerErrorInfo .

E_OUTOFMEMORY
Minnesslut.

E_UNEXPECTED
Anropet till metoden var oväntat. Till exempel anropades inte metoden IBCPSession::BCPInit innan denna metod anropades.