IBCPSession::BCPReadFmt (OLE DB)

Si applica a: SQL Server (tutte le versioni supportate) Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW)

Scaricare il driver 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. La versione del file di formato supportata dal metodo BCP di OLE DB Driver per SQL Server è la 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 valore BCP_OPTION_DELAYREADFMT 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.

Vedere anche

IBCPSession (OLE DB)
Esecuzione di operazioni di copia bulk