Delen via


IBCPSession::BCPReadFmt (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

Leet formaatinformatie voor elke kolom uit het formaatbestand.

Syntaxis

  
HRESULT BCPReadFmt(   
      const wchar_t *pwszFormatFile);  

Opmerkingen

De BCPReadFmt-methode wordt gebruikt om gegevens uit een formaat bestand te lezen dat het formaat van de gegevens in het databestand specificeert. Deze methode is in staat de juiste versie van het formaatbestand te detecteren. Het kan automatisch detecteren of het formaat bestand in xml- of ouderwetse tekstformaat is en gedraagt zich dienovereenkomstig. De formatenbestanden die worden ondersteund door de OLE DB Driver voor SQL Server BCP zijn versie 6.0 of nieuwer.

Nadat de BCPReadFmt-methode de formaatwaarden heeft gelezen, maakt deze de juiste aanroepen naar de IBCPSession::BCPColumns en IBCPSession::BCPColFmt-methoden . De gebruiker hoeft een formateerbestand niet te parsen en deze aanroepen te maken.

Om een formaatbestand op te slaan, roep de IBCPSession::BCPWriteFmt-methode aan. Aanroepen naar de BCPReadFmt-methode kunnen naar opgeslagen formaten verwijzen. Als alternatief kan het bulk-copy utility (bcp) door de gebruiker gedefinieerde dataformaten opslaan in bestanden die via de BCPReadFmt-methode kunnen worden geraadpleegd.

De BCP_OPTION_DELAYREADFMT waarde van de eOption-parameter van IBCPSession::BCPControl wijzigt het gedrag van IBCPSession::BCPReadFmt.

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 deed zich een provider-specifieke fout voor; voor gedetailleerde informatie kun je de ISQLServerErrorInfo-interface gebruiken.

E_OUTOFMEMORY
Fout met onvoldoende geheugen.

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

Zie ook

IBCPSession (OLE DB)
Uitvoeren van bulkkopiebewerkingen