IBCPSession::BCPWriteFmt (Native Client OLE DB Provider)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Ważna

SQL Server Native Client (często skracany jako SNAC) został usunięty z SQL Server 2022 (16.x) i SQL Server Management Studio 19 (SSMS). Zarówno dostawca OLE DB klienta natywnego programu SQL Server (SQLNCLI lub SQLNCLI11), jak i starszy dostawca MICROSOFT OLE DB dla programu SQL Server (SQLOLEDB) nie są zalecane w przypadku nowego programowania. Przełącz się na nowy sterownik Microsoft OLE DB (MSOLEDBSQL) dla programu SQL Server na przyszłość.

Zapisuje informacje o formacie dla każdej kolumny do pliku formatującego.

Syntax

  
HRESULT BCPWriteFmt(   
      const wchar_t *pwszFormatFile);

Remarks

Plik formatu określa format danych pliku danych utworzonego przez kopiowanie masowe. Wywołania metod IBCPSession::BCPColumns i IBCPSession::BCPColFmt definiują format pliku danych. Metoda BCPWriteFmt zapisuje tę definicję w pliku odwołanym przez argument pwszFormatFile.

Metoda BCPWriteFmt może zapisywać pliki formatowane zarówno w formacie xml, jak i tekstowym. Należy to zaznaczyć, używając opcji sterowania BCP_OPTION_XML metodą IBCPSession::BCPControl .

Aby załadować zapisany plik formatu, użyj metody IBCPSession::BCPReadFmt .

Arguments

pwszFormatFile[in]
Ścieżka i nazwa pliku zawierającego wartości formatu dla pliku danych.

Wartości kodów zwracanych

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_OUTOFMEMORY
Błąd z powodu braku pamięci.

E_UNEXPECTED
Wywołanie metody było nieoczekiwane. Na przykład metoda IBCPSession::BCPInit nie była wywoływana przed wywołaniem tej metody.

Treści powiązane

  • Last updated on