Freigeben über


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.

HinweisHinweis

Die von der BCPWriteFmt-Methode erstellte Formatdatei wird nur von Versionen des in Version SQL Server 7.0 oder höher enthaltenen Dienstprogramms 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

Andere Ressourcen