Freigeben über


IBCPSession::BCPColumns (OLE DB)

Legt die Anzahl von Feldern fest, die an die Spalten einer SQL Server-Tabelle gebunden werden sollen.

Syntax

HRESULT BCPColumns( 
      DBCOUNTITEM nColumns);

Hinweise

Intern wird IBCPSession::BCPColFmt aufgerufen, um die Standardwerte für Felddaten festzulegen. Diese Standardwerte werden aus den SQL Server-Spalteninformationen abgerufen, die der Anbieter intern abruft, wenn der Tabellenname über IBCPSession::BCPInit angegeben wird.

HinweisHinweis

Diese Methode kann erst nach dem Aufruf von BCPInit mit einem gültigen Dateinamen aufgerufen werden.

Sie sollten diese Methode nur aufrufen, wenn Sie ein Benutzerdateiformat verwenden möchten, das sich vom Standardformat unterscheidet. Weitere Informationen mit einer Beschreibung des Standardformats für Benutzerdateien finden Sie unter der BCPInit-Methode.

Nach dem Aufruf der BCPColumns-Methode müssen Sie für alle Spalten in der Benutzerdatei die BCPColFmt-Methode aufrufen, um das benutzerdefinierte Dateiformat vollständig zu definieren.

Argumente

  • nColumns[in]
    Die Gesamtzahl der Felder in der Benutzerdatei. Auch wenn Sie das Massenkopieren von Daten aus der Benutzerdatei in eine SQL Server-Tabelle vorbereiten und nicht alle Felder in der Benutzerdatei kopieren möchten, müssen Sie das nColumns-Argument auf die Gesamtzahl der Benutzerdateifelder festlegen. Die übersprungenen Felder können dann durch BCPColFmt angegeben werden.

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_UNEXPECTED
    Die Methode wurde unerwartet aufgerufen. Die BCPInit-Methode wurde beispielsweise erst nach dem Aufruf dieser Methode aufgerufen. Tritt auch auf, wenn diese Methode mehr als einmal für einen Massenkopiervorgang aufgerufen wird.

  • E_OUTOFMEMORY
    Fehler aufgrund von nicht genügend Arbeitsspeicher

Siehe auch

Konzepte

Durchführen von Massenkopiervorgängen

Andere Ressourcen

IBCPSession (OLE DB)