Freigeben über


'IBCPSession::BCPReadFmt' (OLE DB)

Liest für jede Spalte Formatinformationen aus der Formatdatei.

Syntax

HRESULT BCPReadFmt( 
      const wchar_t *pwszFormatFile);

Hinweise

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. Der OLE DB-Anbieter BCP von SQL Server Native Client unterstützt Formatdateien der Version 6.0 oder höher.

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

Um eine Formatdatei zu speichern, rufen Sie 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 eOption-Parameters 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.

Siehe auch

Konzepte

Durchführen von Massenkopiervorgängen

Andere Ressourcen

IBCPSession (OLE DB)