IBCPSession::BCPWriteFmt (Native Client OLE DB Provider)

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Schrijft formaatinformatie voor elke kolom naar het formaatbestand.

Syntax

  
HRESULT BCPWriteFmt(   
      const wchar_t *pwszFormatFile);  

Remarks

Het formaatbestand specificeert het dataformaat van een databestand dat door bulkkopiëren is gemaakt. Aanroepen naar de IBCPSession::BCPColumns en IBCPSession::BCPColFmt methoden definiëren het formaat van het databestand. De BCPWriteFmt-methode slaat deze definitie op in het bestand waarnaar wordt verwezen door het pwszFormatFile-argument.

De BCPWriteFmt-methode kan de bestandsbestanden opslaan in zowel xml- als tekstformaat. Dit moet worden aangegeven door gebruik te maken van de BCP_OPTION_XML control-optie met de IBCPSession::BCPControl-methode .

Om een opgeslagen bestandsbestand te laden, gebruik je de IBCPSession::BCPReadFmt-methode .

Arguments

pwszFormatFile[in]
Het pad en de bestandsnaam van het bestand met de formaatwaarden van het databestand.

Retourcodewaarden

S_OK
De methode slaagde.

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

E_OUTOFMEMORY
Fout uit het geheugen.

E_UNEXPECTED
De aanroep van de methode was onverwacht. Bijvoorbeeld, de IBCPSession::BCPInit-methode werd niet aangeroepen voordat deze methode werd aangetrokken.

Verwante onderwerpen

• IBCPSession (Native Client OLE DB Provider)
• Bulkkopieerbewerkingen uitvoeren in de native client van SQL Server