Condividi tramite


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

Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (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.

Scrive informazioni sul formato per ogni colonna nel file di formato.

Sintassi

  
HRESULT BCPWriteFmt(   
      const wchar_t *pwszFormatFile);  

Osservazioni:

Il file di formato specifica il formato dei dati di un file di dati creato dalla copia bulk. Le chiamate ai metodi IBCPSession::BCPColumns e IBCPSession::BCPColFmt definiscono il formato del file di dati. Il metodo BCPWriteFmt salva questa definizione nel file a cui fa riferimento l'argomento pwszFormatFile.

Il metodo BCPWriteFmt può salvare i file di formato in formato XML o testo. Il formato deve essere indicato utilizzando l'opzione di controllo BCP_OPTION_XML con il metodo IBCPSession::BCPControl.

Per caricare un file di formato salvato, utilizzare il metodo 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