IBCPSession::BCPWriteFmt (OLE DB)

Schreibt für jede Spalte Formatinformationen in die Formatdatei.

Syntax

HRESULT BCPWriteFmt( 
      const wchar_t *pwszFormatFile);

Hinweise

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-Steueroption und der IBCPSession::BCPControl-Methode angegeben werden.

Um eine gespeicherte Formatdatei zu laden, verwenden Sie die IBCPSession::BCPReadFmt-Methode.

Hinweis
Die von der BCPWriteFmt-Methode erstellte Formatdatei wird nur von Versionen des in Version SQL Server 7.0 oder höher enthaltenen Hilfsprogramms bcp unterstützt.

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 anwenderspezifischer Fehler ist aufgetreten. Ausführlichere 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.

Siehe auch

Konzepte

Durchführen von Massenkopiervorgängen

Andere Ressourcen

IBCPSession (OLE DB)