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

Imposta il numero di campi da associare alle colonne di una tabella di SQL Server.

Sintassi

  
HRESULT BCPColumns(   
      DBCOUNTITEM nColumns);  

Osservazioni:

Chiama internamente IBCPSession::BCPColFmt per impostare i valori predefiniti per i dati dei campi. Questi valori predefiniti vengono ottenuti dalle informazioni sulle colonne di SQL Server recuperate internamente dal provider quando si specifica il nome di tabella tramite IBCPSession::BCPInit.

Nota

È possibile chiamare questo metodo solo dopo avere chiamato BCPInit con un nome di file valido.

È consigliabile chiamare questo metodo solo se si intende utilizzare un formato di file utente diverso da quello predefinito. Per ulteriori informazioni su una descrizione del formato di file utente predefinito, vedere il metodo BCPInit.

Dopo avere chiamato il metodo BCPColumns, è necessario chiamare il metodo BCPColFmt per ogni colonna del file utente per definire in modo completo un formato di file personalizzato.

Argomenti

nColumns[in]
Numero totale di campi nel file utente. Anche se si prepara la copia bulk dei dati dal file utente in una tabella di SQL Server e non si prevede di copiare tutti i campi del file utente, è comunque necessario impostare l'argomento nColumns sul numero totale di campi del file utente. I campi ignorati possono quindi essere specificati tramite BCPColFmt.

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_UNEXPECTED
La chiamata al metodo non era prevista. Non è stato ad esempio chiamato il metodo BCPInit prima della chiamata a questo metodo. Si verifica inoltre quando questo metodo viene chiamato più volte per un'operazione di copia bulk.

E_OUTOFMEMORY
Errore di memoria insufficiente.

Vedi anche

IBCPSession (OLE DB)
Esecuzione di operazioni di copia bulk