Delen via


IBCPSession::BCPColumns (OLE DB)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform Systeem (PDW)SQL-database in Microsoft Fabric

OLE DB-stuurprogramma downloaden

Stelt het aantal velden in dat gebonden moet worden aan de kolommen in een SQL Server-tabel.

Syntaxis

  
HRESULT BCPColumns(   
      DBCOUNTITEM nColumns);  

Opmerkingen

Intern roept het IBCPSession::BCPColFmt aan om de standaardwaarden voor veldgegevens in te stellen. Deze standaardwaarden worden verkregen uit de kolominformatie van de SQL Server die de provider intern ophaalt wanneer de tabelnaam wordt opgegeven via IBCPSession::BCPInit.

Opmerking

Deze methode kan alleen worden aangeroepen nadat BCPInit is aangeroepen met een geldige bestandsnaam.

Je moet deze methode alleen aanroepen als je van plan bent een gebruikersbestandsformaat te gebruiken dat afwijkt van de standaard. Voor meer informatie over een beschrijving van het standaard gebruikersbestandsformaat, zie de BCPInit-methode .

Na het aanroepen van de BCPColumns-methode moet je voor elke kolom in het gebruikersbestand de BCPColFmt-methode aanroepen om een aangepast bestandsformaat volledig te definiëren.

Arguments

nColumns[in]
Het totale aantal velden in het gebruikersbestand. Zelfs als je je voorbereidt om data uit het gebruikersbestand in bulk te kopiëren naar een SQL Server-tabel en niet van plan bent alle velden in het gebruikersbestand te kopiëren, moet je het nColumns-argument nog steeds instellen op het totale aantal gebruikersbestandvelden. De overgeslagen velden kunnen vervolgens worden gespecificeerd via BCPColFmt.

Retourcodewaarden

S_OK
De methode slaagde.

E_FAIL
Er is een providerspecifieke fout opgetreden; gebruik de interface ISQLServerErrorInfo voor gedetailleerde informatie.

E_UNEXPECTED
De aanroep van de methode was onverwacht. Bijvoorbeeld, de BCPInit-methode werd niet aangeroepen voordat deze methode werd aangeroepen. Komt ook voor wanneer deze methode meer dan eens wordt aangeroepen voor een bulk-kopieeroperatie.

E_OUTOFMEMORY
Fout uit het geheugen.

Zie ook

IBCPSession (OLE DB)
Uitvoeren van bulkkopiebewerkingen