SQLWriteDSNToIni 函式

一致性
引進的版本: ODBC 1。0

總結
SQLWriteDSNToIni 會將資料來源新增至系統資訊。

語法

  
BOOL SQLWriteDSNToIni(  
     LPCSTR   lpszDSN,  
     LPCSTR   lpszDriver);  

引數

lpszDSN
輸出要加入之資料來源的名稱。

lpszDriver
輸出驅動程式描述 (通常會將相關聯的 DBMS 名稱) 呈現給使用者,而不是實體驅動程式名稱。

傳回

如果成功,函數會傳回 TRUE,否則會傳回 FALSE。

診斷

SQLWriteDSNToIni 傳回 FALSE 時,可以藉由呼叫 SQLInstallerError 來取得相關聯的 * pfErrorCode 值。 下表列出可由 SQLInstallerError 傳回的 * pfErrorCode 值,並在此函式的內容中說明每一個值。

*pfErrorCode 錯誤 描述
ODBC_ERROR_GENERAL_ERR 一般安裝程式錯誤 發生沒有特定安裝程式錯誤的錯誤。
ODBC_ERROR_INVALID_DSN 不正確 DSN LpszDSN 引數包含對 DSN 不正確字串。
ODBC_ERROR_INVALID_NAME 不正確驅動程式或翻譯工具名稱 LpszDriver 引數無效。
ODBC_ERROR_REQUEST_FAILED 要求失敗 安裝程式無法在登錄中建立 DSN。
ODBC_ERROR_OUT_OF_MEM 記憶體不足 因為記憶體不足,所以安裝程式無法執行函數。

註解

SQLWriteDSNToIni 會將資料來源加入系統資訊的 [ODBC 資料來源] 區段。 然後,它會建立資料來源的規格區段,並使用驅動程式 DLL 的名稱做為其值,新增單一關鍵字 (驅動程式) 。 如果資料來源規格區段已存在, SQLWriteDSNToIni 會在建立新區段之前,先將它移除。

此函式的呼叫者必須將任何驅動程式特定的關鍵字和值加入系統資訊的資料來源規格區段。

如果資料來源的名稱是預設值, SQLWriteDSNToIni 也會在系統資訊中建立預設的驅動程式規格區段。

這個函式只能從安裝 DLL 呼叫。

如需下列資訊 請參閱
加入、修改或移除資料來源 安裝 DLL 中的ConfigDSN ()
加入、修改或移除資料來源 SQLConfigDataSource
從系統資訊中移除資料來源名稱 SQLRemoveDSNFromIni