INF Ini2Reg 指示詞
Ini2Reg 指示詞會參考一或多個具名區段,其中提供的 INI 檔案中的行或區段會移至登錄中。 這會在指定的索引鍵下建立或取代一或多個值專案。
[DDInstall] |
[DDInstall.CoInstallers] |
[ClassInstall32] |
[ClassInstall32.ntx86] |
[ClassInstall32.ntia64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntamd64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows)
[ClassInstall32.ntarm64] (Windows 10 version 1709 and later versions of Windows)
Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Ini2Reg 指示詞所參考的每個具名區段都有下列形式:
[ini-to-registry-section]
ini-file,ini-section,[ini-key],reg-root,subkey[,flags]
...
ini-to-registry-section 可以有任何 INF 寫入器決定的項目數目,每個專案位於個別行上。
項目
ini-file
指定來源媒體上提供的 INI 檔案名稱。 此值可以表示為檔名,或以 INF 檔案之 Strings 區段中定義的 %strkey% 令牌表示。
ini-section
指定指定 INI 檔案內區段的名稱,其中包含要複製的登錄資訊。
ini-key
指定要複製到登錄之 INI 檔案中的機碼名稱。 如果省略這個值,則會將整個 ini 區段 傳送至指定的登錄 子機碼。
reg-root
識別這個專案中提供之其他值的登錄樹狀目錄根目錄。 如需詳細資訊,請參閱 AddReg 指示詞的參考。
子機碼
識別要接收值的子機碼,表示為 INF 之 Strings 區段中定義的 %strkey% 令牌,或從指定的 reg-root 明確登錄路徑 (key1\key2\key3...) 表示。
flags
指定在將指定資訊傳送至登錄後如何處理 INI 檔案,以及/或 (位 1) 是否要覆寫現有的登錄資訊,如下所示:
位零 = 0
在將資訊複製到登錄之後,請勿從 INI 檔案中移除指定的資訊。 這是預設值。
位零 = 1
將 INI 檔案移至登錄之後,請從 INI 檔案中刪除指定的資訊。
位一 = 0
如果登錄中已經有指定的子機碼,請勿將 INI 提供的資訊傳送到這個 子機碼中。 否則,請在登錄中建立指定的 子機碼 ,並使用此 INI 提供的資訊作為其值專案。 這是預設值。
位一 = 1
如果登錄中已經有指定的子機碼,請使用 INI 提供的資訊取代其值專案。
備註
Ini2Reg 指示詞在正式語法語句所示的任何區段中都有效。 這個指示詞也適用於 AddInterface 指示詞所參考的 INF 寫入器定義區段,或在 InterfaceInstall32 區段中參考。
如果使用 INF 檔案在 Windows XP 和更新版本的 Windows 上安裝裝置,INF 檔案不應該包含 Ini2Reg 指示詞。 包含 Ini2Reg 指示詞的 INF 檔案不會通過 「專為 Windows 設計」的標誌測試,將不會收到數位簽名,因此 Windows 將不會受信任(請參閱 Windows 選取驅動程式的方式)。
每個 ini-to-registry-section 名稱都必須是 INF 檔案的唯一名稱。 每個 INF 寫入器建立的區段名稱在 INF 檔案內都必須是唯一的,而且必須遵循定義區段名稱的一般規則。 如需這些規則的詳細資訊,請參閱 INF 檔案的一般語法規則。
INF 會以下列其中一種方式,在散發媒體上提供指定 ini-file 的完整路徑:
在 IHV/OEM 提供的 INF 檔案中,藉由使用 SourceDisksNames 以及此 INF 的 SourceDisksFiles 區段,明確指定散發媒體上不在根目錄(或目錄)中之每個具名來源檔案的完整路徑。
在系統提供的 INF 檔案中,藉由提供一或多個額外的 INF 檔案,在 INF 檔案的 Version 區段中的 LayoutFile 項目中識別。