IBCPSession::BCPReadFmt (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).

Liest für jede Spalte Formatinformationen aus der Formatdatei.

Syntax

  
HRESULT BCPReadFmt(   
      const wchar_t *pwszFormatFile);  

Bemerkungen

Die BCPReadFmt -Methode wird verwendet, um Daten aus einer Formatdatei zu lesen, die das Format der Daten in der Datendatei angibt. Diese Methode kann die korrekte Version der Formatdatei ermitteln. Sie kann automatisch erkennen, ob die Formatdatei im XML-Format oder dem alten Textformat abgefasst ist und sich entsprechend verhält. Die vom SQL Server Native Client OLE DB-Anbieter BCP unterstützten Formatdateiversionen sind Version 6.0 oder höher.

Nachdem die BCPReadFmt-Methode die Formatwerte gelesen hat, nimmt sie geeignete Aufrufe der Methoden IBCPSession::BCPColumns und IBCPSession::BCPColFmt vor. Der Benutzer muss eine Formatdatei nicht analysieren, um diese Aufrufe zu tätigen.

Rufen Sie zum Speichern einer Formatdatei die IBCPSession::BCPWriteFmt-Methode auf. Aufrufe der BCPReadFmt -Methode können auf gespeicherte Formate verweisen. Alternativ dazu kann das Hilfsprogramm zum Massenkopieren (bcp) benutzerdefinierte Datenformate in Dateien speichern, auf die mit der BCPReadFmt -Methode verwiesen werden kann.

Der BCP_OPTION_DELAYREADFMT-Wert des Parameters eOption von IBCPSession::BCPControl ändert das Verhalten von „IBCPSession::BCPReadFmt“.

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 von nicht genügend Arbeitsspeicher.

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