SetupQuerySourceListA 函式 (setupapi.h)

[此函式可用於需求一節中所述的操作系統。它在後續版本中可能會變更或無法使用。安裝程式API不應再用於安裝應用程式。請改用 Windows Installer 來開發應用程式安裝程式。 SetupAPI 會繼續用於安裝設備驅動器。]

SetupQuerySourceList 函式會查詢目前的安裝來源清單。此清單是從系統和使用者特定清單建置的，而且可能由暫存清單覆寫， (請參閱 SetupSetSourceList) 。

語法

WINSETUPAPI BOOL SetupQuerySourceListA(
  [in]      DWORD Flags,
  [in, out] PCSTR **List,
  [in, out] PUINT Count
);

[in] Flags

指定要查詢的清單。此參數可以是下列值的任何組合。

查詢系統清單。

查詢每個用戶清單。

注意如果系統與使用者清單都已擷取，則會與系統清單中出現的這些項目合併。

注意如果未指定上述旗標，則會傳回整個目前 (合併) 清單。

一般而言，如果平臺特定元件是最終元件，則會移除所有路徑。例如，以 f：\x86 的形式儲存在登錄中的路徑會以 f：傳回。如果指定此旗標，則不會移除平臺特定元件。

[in, out] List

此函式傳回來源陣列之指標的變數指標。使用以 Null 結尾的字串。呼叫端必須釋放此陣列，並呼叫 SetupFreeSourceList。

[in, out] Count

此函式傳回清單中來源數目的變數指標。

如果函式成功，則傳回值是非零值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

注意

setupapi.h 標頭會將 SetupQuerySourceList 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。