IBCPSession::BCPColumns (OLE DB)

Legt die Anzahl der Felder fest, die an die Spalten in einer SQL Server-Tabelle gebunden werden sollen.

Syntax

  
HRESULT BCPColumns(   
DBCOUNTITEMnColumns);  

Bemerkungen

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.

Sie sollten diese Methode nur aufrufen, wenn Sie ein Benutzerdateiformat verwenden möchten, das sich von der Standardeinstellung unterscheidet. Weitere Informationen zu einer Beschreibung des Standardmäßigen Benutzerdateiformats finden Sie unter der BCPInit-Methode .

Nach dem Aufrufen der BCPColumns-Methode müssen Sie die BCPColFmt-Methode für jede Spalte in der Benutzerdatei aufrufen, um ein benutzerdefiniertes Dateiformat vollständig zu definieren.

Argumente

nColumns[in]
Die Gesamtzahl der Felder in der Benutzerdatei. Selbst wenn Sie die Massenkopie von Daten aus der Benutzerdatei in eine SQL Server-Tabelle vorbereiten und nicht beabsichtigen, alle Felder in der Benutzerdatei zu kopieren, müssen Sie das Argument "nColumns" weiterhin auf die Gesamtanzahl der Benutzerdateifelder festlegen. Die übersprungenen Felder können dann über BCPColFmt angegeben werden.

Rückgabecodewerte

S_OK
Die Methode war erfolgreich.

E_FAIL
Ein anbieterspezifischer Fehler ist aufgetreten; um detaillierte Informationen zu erhalten, verwenden Sie die ISQLServerErrorInfo-Schnittstelle .

E_UNEXPECTED
Der Aufruf der Methode war unerwartet. Die BCPInit-Methode wurde beispielsweise vor dem Aufrufen dieser Methode nicht aufgerufen. Tritt auch auf, wenn diese Methode für einen Massenkopievorgang mehrmals aufgerufen wird.

E_OUTOFMEMORY
Fehler beim Ausfall des Arbeitsspeichers.

Siehe auch

IBCPSession (OLE DB)
Durchführung von Massendatenkopien