IBCPSession::BCPReadFmt (OLE DB)
Legge le 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 i formati di dati definiti dall'utente in file ai quali può fare riferimento il metodo BCPReadFmt.
Il valore BCP_OPTION_DELAYREADFMT del parametro eOption di IBCPSession::BCPControl consente di modificare il comportamento di IBCPSession::BCPReadFmt.
Argomenti
- pwszFormatFile[in]
Percorso e nome del file contenente i valori di formato per il file di dati.
Valori di 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.
Vedere anche
Concetti
Esecuzione di operazioni di copia bulk