IBCPSession::BCPColumns (OLE DB)
設定要繫結至 SQL Server 資料表中之資料行的欄位數目。
語法
HRESULT BCPColumns(
DBCOUNTITEM nColumns);
備註
它會在內部呼叫 IBCPSession::BCPColFmt 來設定欄位資料的預設值。這些預設值會從 SQL Server 資料行資訊取得，提供者會在透過 IBCPSession::BCPInit 指定資料表名稱時，在內部擷取這項資訊。
[!附註]
只有在已使用有效的檔名呼叫 BCPInit 後，才可以呼叫這個方法。
只有打算使用與預設值不同的使用者檔案格式時，才可以呼叫此方法。如需有關預設使用者檔案格式之描述的詳細資訊，請參閱 BCPInit 方法。
在呼叫 BCPColumns 方法之後，您必須針對使用者檔案中的每個資料行呼叫 BCPColFmt 方法，以完整定義自訂的檔案格式。
引數
- nColumns[in]
使用者檔案中的欄位總數。即使您準備要將資料從使用者檔案大量複製到 SQL Server 資料表，而不想複製使用者檔案中的所有欄位，也仍必須將 nColumns 引數設定為使用者檔案欄位的總數。接著，系統可以透過 BCPColFmt 指定略過的欄位。
傳回碼值
S_OK
此方法已成功。E_FAIL
發生提供者特定的錯誤，如需詳細資訊，請使用 ISQLServerErrorInfo 介面。E_UNEXPECTED
呼叫方法是非預期的。例如，在呼叫這個方法之前，不會呼叫 BCPInit 方法。針對大量複製作業呼叫此方法超過一次時，也會發生這個狀況。E_OUTOFMEMORY
記憶體不足錯誤。