共用方式為

SQLRemoveTranslator 函式

  • 發行項

一致性
引進的版本：ODBC 3.0

摘要
SQLRemoveTranslator 會從系統資訊的 Odbcinst.ini 區段中移除翻譯工具的相關資訊，並將翻譯工具的元件使用量計數遞減 1。

語法

  
BOOL SQLRemoveTranslator(  
     LPCSTR    lpszTranslator,  
     LPDWORD   lpdwUsageCount);

引數

lpszTranslator
[輸入]在系統資訊之 Odbcinst.ini 索引鍵中註冊的翻譯工具名稱。

lpdwUsageCount
[輸出]呼叫此函式之後翻譯工具的使用計數。

傳回

如果函式成功，則傳回 TRUE，如果失敗，則傳回 FALSE。 如果呼叫此函式時系統資訊中沒有任何專案存在，則函式會傳回 FALSE。

診斷

當 SQLRemoveTranslator 傳回 FALSE 時 ，可以呼叫 SQLInstallerError 來取得相關聯的 *pfErrorCode 值。 下表列出 SQLInstallerError 可傳 回的 *pfErrorCode 值，並說明此函式內容中的每個值。

*pfErrorCode 錯誤 描述
ODBC_ERROR_GENERAL_ERR 一般安裝程式錯誤 發生錯誤，沒有特定的安裝程式錯誤。
ODBC_ERROR_COMPONENT_NOT_FOUND 登錄中找不到元件 安裝程式無法移除翻譯工具資訊，因為它不存在於登錄中或登錄中找不到。
ODBC_ERROR_INVALID_NAME 不正確驅動程式或翻譯工具名稱 lpszTranslator 引數無效。
ODBC_ERROR_USAGE_UPDATE_FAILED 無法遞增或遞減元件使用量計數 安裝程式無法遞減驅動程式的使用計數。
ODBC_ERROR_OUT_OF_MEM 記憶體不足 由於記憶體不足，安裝程式無法執行函式。

註解

SQLRemoveTranslator 可 補充 SQLInstallTranslatorEx 函式，並更新系統資訊中的元件使用計數。 此函式只能從安裝應用程式呼叫。

SQLRemoveTranslator 會將元件使用量計數遞減 1。 如果元件使用量計數移至 0，系統資訊中的翻譯工具專案將會移除。 翻譯工具專案位於系統資訊中的下列位置，位於翻譯工具名稱底下：

HKEY_LOCAL_MACHINE

SOFTWARE

ODBC

Odbcinst.ini

SQLRemoveTranslator 實際上不會移除任何檔案。 呼叫程式負責刪除檔案，並維護檔案使用計數。 只有在元件使用量計數和檔案使用計數都達到零之後，才會實際刪除檔案。 元件中的某些檔案可以刪除，而其他檔案則無法刪除，視其他已遞增檔案使用量計數的應用程式是否使用檔案而定。

SQLRemoveTranslator 也稱為升級程式的一部分。 如果應用程式偵測到它必須執行升級，且先前已安裝驅動程式，則應該移除驅動程式，然後重新安裝。 應先呼叫 SQLRemoveTranslator 以遞減元件使用量計數，然後 呼叫 SQLInstallTranslatorEx 以遞增元件使用量計數。 應用程式安裝程式必須以新的檔案實際取代舊檔案。 檔案使用計數會維持不變，而使用舊版檔案的其他應用程式現在會使用較新版本。

如需下列資訊 請參閱
安裝翻譯工具 SQLInstallTranslatorEx