共用方式為

SetupSetSourceListA 函式 （setupapi.h）

  • 發行項

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

SetupSetSourceList 函式可讓呼叫者為目前使用者或系統設定安裝來源清單（所有使用者通用）。

語法

WINSETUPAPI BOOL SetupSetSourceListA(
  [in] DWORD Flags,
  [in] PCSTR *SourceList,
  [in] UINT  SourceCount
);

參數

[in] Flags

指定清單的類型。 此參數可以是下列值的組合。

SRCLIST_SYSTEM

此清單是儲存在登錄中的個別系統最近使用 （MRU） 清單。 呼叫端必須是系統管理員本地組的成員。

SRCLIST_USER

此清單是儲存在登錄中的每個使用者 MRU 清單。

SRCLIST_TEMPORARY

指定的清單是暫時的，而且將是目前程式唯一可存取的清單，直到呼叫 SetupCancelTemporarySourceList，或再次呼叫 SetSourceList 為止。

重要 如果設定暫存清單，即使後續 呼叫 setupAddToSourceList 或 SetupRemoveFromSourceList 明確指定這些列表，也不會從系統或使用者清單中新增或刪除來源。
 
注意 必須指定其中一個SRCLIST_SYSTEM、SRCLIST_USER或SRCLIST_TEMPORARY旗標。
 

SRCLIST_NOBROWSE

使用 SetupPromptForDisk 時，不允許使用者新增或變更來源。 此旗標通常與 SRCLIST_TEMPORARY 旗標搭配使用。

[in] SourceList

要當做來源清單使用的字串數組指標，如 Flags 參數所指定。

[in] SourceCount

SourceList 所指向的陣列中元素數目，。

傳回值

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

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

言論

注意

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

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 setupapi.h
連結庫 Setupapi.lib
DLL Setupapi.dll

另請參閱

函式

概觀

SetupAddToSourceList

SetupCancelTemporarySourceList

SetupRemoveFromSourceList