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

Si applica a:SQL ServerDatabase SQL diAzure Istanzagestita di SQL di Azure Azure Synapse Analytics PlatformSystem (PDW)

Importante

SQL Server Native Client (spesso abbreviato SNAC) è stato rimosso da SQL Server 2022 (16.x) e SQL Server Management Studio 19 (SSMS). Non è consigliabile usare sia il provider OLE DB SQL Server Native Client (SQLNCLI o SQLNCLI11) che il provider Microsoft OLE DB legacy per SQL Server (SQLOLEDB). Passare al nuovo Microsoft OLE DB Driver (MSOLEDBSQL) per SQL Server in futuro.

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