Direktif INF Ini2Reg
Perhatian
Mulai Windows 11 versi 22H2, paket driver yang menggunakan arahan ini tidak lagi memenuhi syarat untuk tanda tangan dari Pusat Pengembang Perangkat Keras.
Paket pengandar universal dan Driver Windows tidak dapat menggunakan direktif ini.
Direktif Ini2Reg mereferensikan satu atau beberapa bagian bernama di mana baris atau bagian dari file INI yang disediakan dipindahkan ke registri. Ini membuat atau mengganti satu atau beberapa entri nilai di bawah kunci tertentu.
[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]...
Setiap bagian bernama yang direferensikan oleh direktif Ini2Reg memiliki formulir berikut:
[ini-to-registry-section]
ini-file,ini-section,[ini-key],reg-root,subkey[,flags]
...
Bagian ini-ke-registri dapat memiliki jumlah entri yang ditentukan inf-writer, masing-masing pada baris terpisah.
Entri
ini-file
Menentukan nama file INI yang disediakan pada media sumber. Nilai ini dapat dinyatakan sebagai nama file atau sebagai token %strkey% yang didefinisikan di bagian String dari file INF.
ini-bagian
Menentukan nama bagian dalam file INI yang diberikan yang berisi informasi registri yang akan disalin.
ini-key
Menentukan nama kunci dalam file INI untuk disalin ke registri. Jika nilai ini dihilangkan, seluruh bagian ini akan ditransfer ke subkuncu registri yang ditentukan.
reg-root
Mengidentifikasi akar pohon registri untuk nilai lain yang disediakan dalam entri ini. Untuk detailnya, lihat referensi untuk direktif AddReg.
subkunjuk
Mengidentifikasi subkunjung untuk menerima nilai, yang dinyatakan sebagai token %strkey% yang ditentukan di bagian String dari INF atau sebagai jalur registri eksplisit (key1\key2\key3...) dari reg-root yang diberikan.
flags
Menentukan (dalam bit 0) cara menangani file INI setelah mentransfer informasi yang diberikan ke registri dan/atau (dalam bit 1) apakah akan menimpa informasi registri yang ada, sebagai berikut:
Bit nol = 0
Jangan hapus informasi yang diberikan dari file INI setelah menyalinnya ke registri. Ini adalah default.
Bit nol = 1
Hapus informasi yang diberikan dari file INI setelah memindahkannya ke registri.
Bit satu = 0
Jika subkuncu yang ditentukan sudah ada di registri, jangan transfer informasi yang disediakan INI ke dalam subkuncuali ini. Jika tidak, buat subkunci yang ditentukan dalam registri dengan informasi yang disediakan INI ini sebagai entri nilainya. Ini adalah default.
Bit satu = 1
Jika subkuntang yang ditentukan sudah ada di registri, ganti entri nilainya dengan informasi yang disediakan INI.
Keterangan
Direktif Ini2Reg valid di salah satu bagian yang ditampilkan dalam pernyataan sintaks formal. Direktif ini juga valid di bagian yang ditentukan inf-writer yang direferensikan oleh direktif AddInterface atau direferensikan di bagian InterfaceInstall32.
Jika file INF digunakan untuk menginstal perangkat pada Windows XP dan versi Windows yang lebih baru, file INF tidak boleh berisi direktif Ini2Reg . File INF yang berisi arahan Ini2Reg tidak akan lulus pengujian logo "Dirancang Untuk Windows", tidak akan menerima tanda tangan digital, dan oleh karena itu akan tidak tepercaya oleh Windows (lihat Bagaimana Windows Memilih Driver).
Setiap nama bagian ini-ke-registri harus unik untuk file INF. Setiap nama bagian yang dibuat inf-writer harus unik dalam file INF dan harus mengikuti aturan umum untuk menentukan nama bagian. Untuk informasi selengkapnya tentang aturan ini, lihat Aturan Sintaks Umum untuk File INF.
INF menyediakan jalur lengkap file ini yang diberikan pada media distribusi dengan salah satu cara berikut:
Dalam file INF yang disediakan IHV/OEM, dengan menggunakan SourceDisksNames dan, mungkin, bagian SourceDisksFiles dari INF ini untuk secara eksplisit menentukan jalur lengkap dari setiap file sumber bernama yang tidak ada di direktori akar (atau direktori) pada media distribusi.
Dalam file INF yang disediakan sistem, dengan menyediakan satu atau beberapa file INF tambahan, yang diidentifikasi dalam entri LayoutFile di bagian Versi file INF.