'IBCPSession::BCPReadFmt' (OLE DB)

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

OLE DB-Treiber herunterladen

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 Formatdateiversionen, die vom Hilfsprogramm BCP des OLE DB-Treibers für SQL Server unterstützt werden, sind Version 6.0 oder neuer.

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