IBCPSession::BCPWriteFmt (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.

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