SQLValidDSN 函式

一致性
引進的版本：ODBC 2.0

摘要
SQLValidDSN 會在將名稱新增至系統資訊之前，檢查資料來源名稱的長度和有效性。

語法

  
BOOL SQLValidDSN(  
     LPCSTR    lpszDSN);  

引數

lpszDSN
[輸入]要檢查的資料來源名稱。

傳回

如果資料來源名稱有效，函式會傳回 TRUE。 如果資料來源名稱無效或函式呼叫失敗，則會傳回 FALSE。

診斷

當 SQLValidDSN 傳回 FALSE 時 ，可以呼叫 SQLInstallerError 來取得相關聯的 *pfErrorCode 值。 只有在函式呼叫失敗時，才會傳回 *pfErrorCode ，而不是因為資料來源名稱無效而傳回 FALSE。 下表列出 SQLInstallerError 可傳 回的 *pfErrorCode 值，並說明此函式內容中的每個值。

*pfErrorCode	錯誤	描述
ODBC_ERROR_GENERAL_ERR	一般安裝程式錯誤	發生錯誤，沒有特定的安裝程式錯誤。
ODBC_ERROR_OUT_OF_MEM	記憶體不足	由於記憶體不足，安裝程式無法執行函式。

註解

驅動程式的 ConfigDSN 會呼叫 SQLValidDSN ，以檢查資料來源名稱的長度和資料來源名稱中個別字元的有效性。 它會檢查名稱長度是否大於 SQL_MAX_DSN_LENGTH，如 Sqlext.h 中所定義。 （資料來源名稱的長度也會由 SQLWriteDSNToIni .） SQLValidDSN 會檢查資料來源名稱中是否包含下列任何無效字元：

[ ] { } ( ) , ; ? * = ! @ \

相關函數

如需下列資訊	請參閱
新增、修改或移除資料來源	ConfigDSN （在安裝 DLL 中）
新增、修改或移除資料來源	SQLConfigDataSource
將資料來源名稱寫入系統資訊	SQLWriteDSNToIni