IBCPSession::BCPColumns (OLE DB)

Si applica a: SQL Server Azure SQL DatabaseIstanza gestita di SQL di Azure Azure SynapseAnalytics AnalyticsPlatform System (PDW)

Scaricare il driver OLE DB

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.

Vedere anche

IBCPSession (OLE DB)
Esecuzione di operazioni di copia bulk