SetupGetInfFileListA 函式 (setupapi.h)
[此函式可用於需求一節中所述的操作系統。 它在後續版本中可能會變更或無法使用。 安裝程式API不應再用於安裝應用程式。 請改用 Windows Installer 來開發應用程式安裝程式。 SetupAPI 會繼續用於安裝設備驅動器。]
SetupGetInfFileList 函式會將位於呼叫端指定目錄中的 INF 檔案清單傳回給呼叫提供的緩衝區。
語法
WINSETUPAPI BOOL SetupGetInfFileListA(
[in] PCSTR DirectoryPath,
[in] DWORD InfStyle,
[in, out] PSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[in, out] PDWORD RequiredSize
);
參數
[in] DirectoryPath
包含要搜尋之目錄路徑之 Null 終止字串的選擇性指標。 如果此值為 NULL,則會使用 %windir%\inf 目錄。
[in] InfStyle
要搜尋的 INF 檔案類型。 可能是下列旗標的組合。
INF_STYLE_OLDNT
舊版 INF 檔案格式。
INF_STYLE_WIN4
Windows INF 檔案格式。
[in, out] ReturnBuffer
如果不是 NULL,則指向緩衝區,在此緩衝區中,此函式會傳回指定子目錄中找到之所需樣式的所有 INF 檔案清單。 檔名會以 Null 結尾結束,並在清單結尾加上額外的 Null 。 以 Null 結束的字串不應超過目的地緩衝區的大小。 您可以呼叫函式一次以取得所需的緩衝區大小、配置必要的記憶體,然後再次呼叫函式以擷取數據。 使用這項技術,您可以避免因為緩衝區大小不足而發生錯誤。 檔名不包含路徑。 請參閱<備註>一節。
[in] ReturnBufferSize
ReturnBuffer 參數所指向的緩衝區大小,以字元為單位。 這包括 Null 終止符。 如果未指定 ReturnBuffer ,則會忽略 ReturnBufferSize 。
[in, out] RequiredSize
如果不是 NULL,則指向變數,在此變數中,此函式會以字元傳回 ReturnBuffer 參數所指向之緩衝區的必要大小。 這包括 Null 終止符。 如果指定 ReturnBuffer 且所需的大小大於 ReturnBufferSize,則函式會失敗,而且 GetLastError 的呼叫會傳回ERROR_INSUFFICIENT_BUFFER。
傳回值
如果函式成功,則傳回值是非零值。
如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
如果使用 NULL 的 ReturnBuffer 和 Zero 的 ReturnBufferSize 呼叫此函式,此函式會將所需的緩衝區大小放入 RequiredSize 所指向的變數中。 如果函式成功,則傳回值是非零值。 否則,傳回值為零,而且呼叫 GetLastError 即可取得擴充錯誤資訊。
如果此函式傳回多個 INF 檔案樣式,可以呼叫 SetupGetInfInfInformation 函式來判斷特定 INF 檔案的樣式
注意
setupapi.h 標頭會將 SetupGetInfFileList 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | setupapi.h |
程式庫 | Setupapi.lib |
Dll | Setupapi.dll |