共用方式為


SQLGetInstalledDrivers 函式

一致性
引進的版本:ODBC 1.0

摘要
SQLGetInstalledDrivers 會讀取系統資訊的 [ODBC 驅動程式] 區段,並傳回已安裝驅動程式的描述清單。

語法

  
BOOL SQLGetInstalledDrivers(  
     LPSTR   lpszBuf,  
     WORD    cbBufMax,  
     WORD *  pcbBufOut);  

引數

lpszBuf
[輸出]已安裝驅動程式的描述清單。 如需清單結構的相關資訊,請參閱。

cbBufMax
[輸入]lpszBuf 長度。

pcbufOut
[輸出]在 lpszBuf 傳回的位元組總數(不包括 Null 終止位元組)。 如果可用的位元組數目大於或等於 cbBufMax ,lpszBuf 中的 驅動程式描述清單會截斷為 cbBufMax 減去 null 終止字元。 因此,blobBufOut 引數可以是 Null 指標。

傳回

如果函式成功,則傳回 TRUE,如果失敗,則傳回 FALSE。

診斷

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

*pfErrorCode 錯誤 描述
ODBC_ERROR_GENERAL_ERR 一般安裝程式錯誤 發生錯誤,沒有特定的安裝程式錯誤。
ODBC_ERROR_INVALID_BUFF_LEN 不正確緩衝區長度 lpszBuf 引數為 Null 或無效,或 cbBufMax 引數小於或等於 0。
ODBC_ERROR_COMPONENT_NOT_FOUND 登錄中找不到元件 安裝程式在登錄中找不到 [ODBC Drivers] 區段。
ODBC_ERROR_OUT_OF_MEM 記憶體不足 由於記憶體不足,安裝程式無法執行函式。

註解

每個驅動程式描述都會以 Null 位元組終止,而整個清單會以 Null 位元組終止。 (也就是說,兩個 Null 位元組會標示清單的結尾。如果配置的緩衝區不夠大而無法保存整個清單,則會截斷清單而不會發生錯誤。 如果 Null 指標以 lpszBuf 的形式傳入 ,則會傳回錯誤。

如需下列資訊 請參閱
傳回驅動程式描述和屬性 SQLDrivers