IBCPSession::BCPColumns (OLE DB)

Dotyczy do:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSystem Platform Analitycznych (PDW)Baza danych SQL w Microsoft Fabric

pobierz sterownik OLE DB

Ustala liczbę pól, które mają być przypisane do kolumn w tabeli SQL Server.

Składnia

  
HRESULT BCPColumns(   
      DBCOUNTITEM nColumns);  

Uwagi

Wewnętrznie wywołuje IBCPSession::BCPColFmt , aby ustawić domyślne wartości dla danych polowych. Te wartości domyślne są uzyskiwane z informacji kolumny SQL Server, które dostawca pobiera wewnętrznie, gdy nazwa tabeli jest określana przez IBCPSession::BCPInit.

Powinieneś wywołać tę metodę tylko wtedy, gdy zamierzasz użyć formatu pliku użytkownika różniącego się od domyślnego. Więcej informacji na temat domyślnego formatu pliku użytkownika można znaleźć w metodzie BCPInit .

Po wywołaniu metody BCPColumns musisz wywołać metodę BCPColFmt dla każdej kolumny w pliku użytkownika, aby całkowicie zdefiniować niestandardowy format pliku.

Arguments

nKolumny[in]
Całkowita liczba pól w pliku użytkownika. Nawet jeśli przygotowujesz się do masowej kopii danych z pliku użytkownika do tabeli SQL Server i nie zamierzasz kopiować wszystkich pól w pliku użytkownika, nadal musisz ustawić argument nColumns na całkowitą liczbę pól pliku użytkownika. Pominięte pola można następnie określić za pomocą BCPColFmt.

Zwracanie wartości kodu

S_OK
Metoda się powiodła.

E_FAIL
Wystąpił błąd specyficzny dla dostawcy; aby uzyskać szczegółowe informacje, użyj interfejsu ISQLServerErrorInfo .

E_UNEXPECTED
Wywołanie metody było nieoczekiwane. Na przykład metoda BCPInit nie była wywoływana przed wywołaniem tej metody. Występuje także, gdy ta metoda jest wywoływana więcej niż raz dla operacji kopiowania masowego.

E_OUTOFMEMORY
Błąd z powodu braku pamięci.

Zobacz też

IBCPSession (OLE DB)
Wykonywanie operacji kopiowania masowego