'IBCPSession::BCPReadFmt' (OLE DB)
Liest für jede Spalte Formatinformationen aus der Formatdatei.
Syntax
HRESULT BCPReadFmt(
const wchar_t *pwszFormatFile);
Hinweise
Die BCPReadFmt-Methode wird verwendet, um Daten aus einer Formatdatei zu lesen, die das Format der Daten in der Datendatei angibt. Diese Methode kann die korrekte Version der Formatdatei ermitteln. Sie kann automatisch erkennen, ob die Formatdatei im XML-Format oder dem alten Textformat abgefasst ist und sich entsprechend verhält. Der OLE DB-Anbieter BCP von SQL Server Native Client unterstützt Formatdateien der Version 6.0 oder höher.
Nachdem die BCPReadFmt-Methode die Formatwerte gelesen hat, nimmt sie geeignete Aufrufe an die Methoden IBCPSession::BCPColumns und IBCPSession::BCPColFmt vor. Der Benutzer muss eine Formatdatei nicht analysieren, um diese Aufrufe zu tätigen.
Um eine Formatdatei zu speichern, rufen Sie die IBCPSession::BCPWriteFmt-Methode auf. Aufrufe der BCPReadFmt-Methode können auf gespeicherte Formate verweisen. Alternativ dazu kann das Dienstprogramm zum Massenkopieren (bcp) benutzerdefinierte Datenformate in Dateien speichern, auf die mit der BCPReadFmt-Methode verwiesen werden kann.
Argumente
- pwszFormatFile[in]
Pfad und Dateiname der Datei, die die Formatwerte für die Datendatei enthält.
Rückgabecodewerte
S_OK
Die Methode wurde erfolgreich ausgeführt.E_FAIL
Ein anbieterspezifischer Fehler ist aufgetreten. Ausführliche Informationen erhalten Sie über die ISQLServerErrorInfo-Schnittstelle.E_OUTOFMEMORY
Fehler aufgrund von nicht genügend Arbeitsspeicher.E_UNEXPECTED
Die Methode wurde unerwartet aufgerufen. Die IBCPSession::BCPInit-Methode wurde beispielsweise erst nach dem Aufruf dieser Methode aufgerufen.