Fungsi InstallHinfSectionW (setupapi.h)

[Fungsi ini tersedia untuk digunakan dalam sistem operasi yang ditunjukkan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. SetupAPI tidak boleh lagi digunakan untuk menginstal aplikasi. Sebagai gantinya, gunakan Penginstal Windows untuk mengembangkan penginstal aplikasi. PenyetelanAPI terus digunakan untuk menginstal pengandar perangkat.]

InstallHinfSection adalah fungsi titik masuk yang diekspor oleh Setupapi.dll yang dapat Anda gunakan untuk menjalankan bagian file .inf.

Nota

Untuk banyak skenario, disarankan agar Anda menggunakan paket driver primitif alih-alih menggunakan file .inf dengan InstallHinfSection

InstallHinfSection dapat dipanggil dengan memanggil utilitas Rundll32.exe seperti yang dijelaskan di bagian Keterangan. Prototipe untuk fungsi InstallHinfSection mengikuti bentuk semua fungsi titik masuk yang digunakan dengan Rundll32.exe.

Jika file disalin atau dimodifikasi, pemanggil fungsi ini diperlukan memiliki hak istimewa untuk menulis ke direktori target. Jika ada layanan yang diinstal, pemanggil fungsi ini diperlukan memiliki akses ke Service Control Manager.

Sintaksis

VOID InstallHinfSectionW(
  [in] HWND      Window,
  [in] HINSTANCE ModuleHandle,
  [in] PCWSTR    CommandLine,
  [in] INT       ShowCommand
);

Parameter

[in] Window

Handel jendela induk. Biasanya null.

[in] ModuleHandle

Dicadangkan dan harus Null.

[in] CommandLine

Penunjuk ke buffer yang berisi baris perintah. Anda harus menggunakan string null-terminated.

[in] ShowCommand

Dicadangkan dan harus nol.

Mengembalikan nilai

Tidak

Komentar

Perhatikan bahwa ada tiga ekspor: InstallHinfSection (untuk RunDll32), InstallHinfSectionA, dan InstallHinfSectionW.

Untuk menjalankan bagian Instal dari file .inf tertentu, Anda dapat memanggil InstallHinfSection dengan Rundll32.exe dengan menggunakan sintaks berikut.

RUNDLL32.EXE SETUPAPI.DLL,InstallHinfSection <section> <mode> <path>

Ini melewati bagian<mode><><jalur>" ke CmdLineBuffer.

Atau, program Anda dapat memanggil InstallHinfSection, InstallHinfSectionA, atau InstallHinfSectionW secara langsung, mengatur parameter CmdLineBuffer ke berikut.

"<section> <mode> <path>"

Di mana jalur adalah jalur lengkap ke file .inf, mode adalah parameter mode reboot, dan bagian adalah bagian Instal dalam file .inf. Pemisah koma antara SETUPAPI.DLL dan InstallHinfSection pada baris perintah diperlukan. Perhatikan bahwa tidak boleh ada spasi kosong pada baris perintah antara koma dan SETUPAPI.DLL atau InstallHinfSection.

Disarankan agar Anda menentukan jalur lengkap ke file .inf sebagai jalur .

Anda dapat menentukan bagian Instal di file .inf sebagai bagian . Tidak ada spasi yang diperbolehkan.

Anda harus menggunakan kombinasi nilai berikut untuk mode . Anda harus menyertakan 128 untuk mengatur jalur default penginstalan ke lokasi INF, jika tidak, INF yang disediakan sistem diasumsikan. Tambahkan nilai untuk menentukan boot ulang. Perhatikan bahwa hanya nilai 128 atau 132 yang direkomendasikan, nilai lain dapat menyebabkan komputer me-reboot secara tidak perlu atau tidak di-boot ulang saat diperlukan.

Nilai	Deskripsi
0	INF yang disediakan sistem.
128	Atur jalur default penginstalan ke lokasi INF. Ini adalah pengaturan umum.
+0	Jangan pernah me-reboot komputer.
+1	Reboot komputer dalam semua kasus.
+2	Selalu tanyakan kepada pengguna apakah mereka ingin memulai ulang.
+3	Reboot komputer jika perlu tanpa meminta izin kepada pengguna.
+4	Jika reboot komputer diperlukan, minta izin kepada pengguna sebelum memulai ulang.

 

 

Misalnya, baris perintah berikut menjalankan bagian DefaultInstall dari file Shell.inf. Jika Penyiapan menentukan reboot diperlukan, pengguna akan diminta dengan kotak dialog "Reboot komputer, Ya/Tidak".

RUNDLL32.EXE SETUPAPI.DLL,InstallHinfSection DefaultInstall 132 C:\Example\SHELL.INF

Nota

Header setupapi.h mendefinisikan InstallHinfSection sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Hati

Saat digunakan pada arsitektur selain x86 atau amd64, atau ketika digunakan pada sistem dalam mode S , InstallHInfSection mengharuskan file INF memiliki bagian Versi INF dengan direktif CatalogFile yang menunjuk pada file katalog yang ditandatangani yang berisi hash file INF dan file apa pun yang direferensikan file INF melalui bagian INF SourceDisksFiles.

Hati

Ketika digunakan pada sistem yang arsitektur aslinya bukan x86 atau amd64, InstallHInfSection harus digunakan dari proses arsitektur asli. InstallHInfSection akan memblokir banyak jenis operasi perubahan status sistem saat digunakan dari proses arsitektur non-asli.

InstallHinfSection akan mencatat informasi diagnostik ke log teks penginstalan aplikasi SetupAPI. File log ini umumnya nonaktif secara default. Ini dapat diaktifkan dengan memodifikasi tingkat pengelogan umum bagian dari nilai LogLevel SetupAPI seperti yang dijelaskan di Mengatur Tingkat Pengelogan SETUPAPI. Untuk alasan performa, Anda hanya boleh mengaktifkan file log ini saat memecahkan masalah. Ketika file log diaktifkan, Anda dapat menemukannya di %windir%\inf\setupapi.app.log.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	setupapi.h
Pustaka	Setupapi.lib
DLL	Setupapi.dll