共用方式為


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