bcp_readfmt

從指定的格式檔案讀取資料檔格式定義。

語法

RETCODE bcp_readfmt (
        HDBC hdbc,
        LPCTSTR szFormatFile);

引數

• hdbc
  這是已啟用大量複製的 ODBC 連接控制代碼。

• szFormatFile
  這是包含資料檔格式值之檔案的路徑和檔案名稱。

傳回值

SUCCEED 或 FAIL。

備註

在 bcp_readfmt 讀取格式值之後，它會適當地呼叫 bcp_columns 和 bcp_colfmt。您不需要剖析格式檔案，也不需要進行這些呼叫。

若要保存格式檔案，呼叫 bcp_writefmt。bcp_readfmt 的呼叫可以參考已儲存的格式。如需詳細資訊，請參閱＜bcp_init＞。

或者，大量複製公用程式 (bcp) 可以將使用者定義資料格式儲存在 bcp_readfmt 可以參考的檔案中。如需有關 bcp 公用程式和 bcp 資料格式檔案結構的詳細資訊，請參閱＜使用格式檔案＞。

[!附註]

bcp 公用程式的 4.2 版或更新版本必須已經產生格式檔案。

範例

// Variables like henv not specified.
HDBC      hdbc;
DBINT      nRowsProcessed;

// Application initiation, get an ODBC environment handle, allocate the
// hdbc, and so on.
... 

// Enable bulk copy prior to connecting on allocated hdbc.
SQLSetConnectAttr(hdbc, SQL_COPT_SS_BCP, (SQLPOINTER) SQL_BCP_ON,
   SQL_IS_INTEGER);

// Connect to the data source, return on error.
if (!SQL_SUCCEEDED(SQLConnect(hdbc, _T("myDSN"), SQL_NTS,
   _T("myUser"), SQL_NTS, _T("myPwd"), SQL_NTS)))
   {
   // Raise error and return.
   return;
   }

// Initialize bulk copy. 
if (bcp_init(hdbc, _T("myTable"), _T("myData.csv"),
   _T("myErrors"),    DB_IN) == FAIL)
   {
   // Raise error and return.
   return;
   }

if (bcp_readfmt(hdbc, _T("myFmtFile.fmt")) == FAIL)
   {
   // Raise error and return.
   return;
   }

if (bcp_exec(hdbc, &nRowsProcessed) == SUCCEED)
   {
   cout << nRowsProcessed << " rows copied to SQL Server\n";
   }

// Carry on.

請參閱

參考

大量複製函數