IBCPSession::BCPReadFmt (OLE DB)
Legge informazioni sul formato per ogni colonna dal file di formato.
Sintassi
HRESULT BCPReadFmt(
const wchar_t *pwszFormatFile);
Osservazioni
Il metodo BCPReadFmt viene utilizzato per la lettura di dati da un file di formato che specifica il formato dei dati nel file di dati. Questo metodo è in grado di rilevare la versione corretta del file di formato. Può rilevare automaticamente se il file è in formato xml o testo stile antico e comportarsi di conseguenza. La versione del file di formato supportata dal metodo BCP del provider OLE DB di SQL Server Native Client è la 6.0 o versioni successive.
Dopo la lettura dei valori del formato, il metodo BCPReadFmt effettua le chiamate appropriate ai metodi IBCPSession::BCPColumns e IBCPSession::BCPColFmt. L'utente può evitare di analizzare un file di formato ed effettuare queste chiamate.
Per salvare un file di formato, chiamare il metodo IBCPSession::BCPWriteFmt. Le chiamate al metodo BCPReadFmt possono fare riferimento ai formati salvati. In alternativa, l'utilità per la copia bulk (bcp) può salvare formati di dati definiti dall'utente nei file ai quali può fare riferimento il metodo BCPReadFmt.
Argomenti
- pwszFormatFile[in]
Percorso e nome del file contenente i valori di formato per il file di dati.
Valori del codice restituiti
S_OK
Il metodo è riuscito.E_FAIL
Si è verificato un errore specifico del provider. Per informazioni dettagliate, utilizzare l'interfaccia ISQLServerErrorInfo.E_OUTOFMEMORY
Errore di memoria insufficiente.E_UNEXPECTED
La chiamata al metodo non era prevista. Non è stato ad esempio chiamato il metodo IBCPSession::BCPInit prima della chiamata a questo metodo.