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 usato 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. Le versioni del file di formato supportate dal provider OLE DB SQL Server Native Client BCP sono versione 6.0 o successiva.
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 BCP_OPTION_DELAYREADFMT valore del parametro eOption di IBCPSession::BCPControl modifica il comportamento di IBCPSession::BCPReadFmt.
Argomenti
pwszFormatFile[in]
Percorso e nome del file contenente i valori di formato per il file di dati.
Valori del codice restituito
S_OK
Il metodo è riuscito.
E_FAIL
Si è verificato un errore specifico del provider. Per informazioni dettagliate, usare 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.