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