IBCPSession::BCPWriteFmt (Native Client OLE DB-Anbieter)

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Wichtig

Der SQL Server Native Client (häufig abgekürzt mit SNAC) wurde aus SQL Server 2022 (16.x) und SQL Server Management Studio 19 (SSMS) entfernt. Sowohl der OLE DB-Anbieter für den SQL Server Native Client (SQLNCLI oder SQLNCLI11) als auch der Microsoft OLE DB-Legacyanbieter für SQL Server (SQLOLEDB) werden für Neuentwicklungen nicht empfohlen. Verwenden Sie in Zukunft den neuen Microsoft OLE DB-Treiber für SQL Server (MSOLEDBSQL).

Schreibt für jede Spalte Formatinformationen in die Formatdatei.

Syntax

  
HRESULT BCPWriteFmt(   
      const wchar_t *pwszFormatFile);  

Bemerkungen

Die Formatdatei gibt das Datenformat einer durch Massenkopieren erstellten Datendatei an. Durch Aufrufe der Methoden IBCPSession::BCPColumns und IBCPSession::BCPColFmt wird das Format der Datendatei definiert. Die Methode BCPWriteFmt speichert diese Definition in der im Argument pwszFormatFile angegebenen Datei.

Die BCPWriteFmt -Methode kann die Formatdateien in XML- oder Textformat speichern. Dies muss mithilfe der BCP_OPTION_XML-Steuerungsoption und der IBCPSession::BCPControl-Methode angegeben werden.

Verwenden Sie die IBCPSession::BCPReadFmt-Methode, um eine gespeicherte Formatdatei zu laden.

Argumente

pwszFormatFile[in]
Pfad und Dateiname der Datei, die die Formatwerte für die Datendatei enthält.

Rückgabecodewerte

S_OK
Die Methode wurde erfolgreich ausgeführt.

E_FAIL
Ein anbieterspezifischer Fehler ist aufgetreten. Ausführliche Informationen erhalten Sie über die ISQLServerErrorInfo-Schnittstelle.

E_OUTOFMEMORY
Fehler aufgrund nicht genügenden Arbeitsspeichers

E_UNEXPECTED
Die Methode wurde unerwartet aufgerufen. Die IBCPSession::BCPInit-Methode wurde beispielsweise erst nach dem Aufruf dieser Methode aufgerufen.

Weitere Informationen

IBCPSession (OLE DB)
Durchführen von Massenkopiervorgängen