IBCPSession::BCPReadFmt (provider OLE DB di Native Client)

Si applica a: SQL Server database SQL di Azure Istanza gestita di SQL di Azure azure Synapse Analytics Analytics Platform System (PDW)

Importante

SQL Server Native Client (spesso abbreviato SNAC) è stato rimosso da SQL Server 2022 (16.x) e da SQL Server Management Studio 19 (SSMS). Il provider OLE DB di SQL Server Native Client (SQLNCLI o SQLNCLI11) e il provider OLE DB legacy Microsoft per SQL Server (SQLOLEDB) non sono consigliati per lo sviluppo di nuove applicazioni. In futuro, passare al nuovo driver Microsoft OLE DB (MSOLEDBSQL) per SQL Server.

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 di 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 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.

Vedi anche

IBCPSession (OLE DB)
Esecuzione di operazioni di copia bulk