Fungsi SetupDiInstallClassExA (setupapi.h)
Fungsi SetupDiInstallClassEx menginstal penginstal kelas atau kelas antarmuka.
Sintaks
WINSETUPAPI BOOL SetupDiInstallClassExA(
[in, optional] HWND hwndParent,
[in, optional] PCSTR InfFileName,
[in] DWORD Flags,
[in, optional] HSPFILEQ FileQueue,
[in, optional] const GUID *InterfaceClassGuid,
PVOID Reserved1,
PVOID Reserved2
);
Parameter
[in, optional] hwndParent
Handel ke jendela induk untuk antarmuka pengguna apa pun yang digunakan untuk menginstal kelas ini. Parameter ini bersifat opsional dan dapat berupa NULL.
[in, optional] InfFileName
Penunjuk ke string yang dihentikan NULL yang berisi nama file INF. Parameter ini bersifat opsional dan dapat berupa NULL. Jika fungsi ini digunakan untuk menginstal penginstal kelas, file INF berisi bagian INF ClassInstall32 dan parameter ini tidak boleh NULL.
Jika fungsi ini digunakan untuk menginstal kelas antarmuka, file INF berisi bagian INF InterfaceInstall32.
[in] Flags
Nilai jenis DWORD yang mengontrol proses penginstalan. Bendera bisa nol atau bitwise ATAU dari nilai berikut:
DI_NOVCP
Atur bendera ini jika FileQueue disediakan.
DI_NOVCP menginstruksikan fungsi SetupInstallFromInfSection untuk tidak membuat antrean sendiri dan menggunakan antrean yang disediakan pemanggil sebagai gantinya.
Jika bendera ini diatur, file tidak disalin hanya dalam antrean.
Untuk informasi selengkapnya tentang fungsi SetupInstallFromInfSection , lihat dokumentasi Microsoft Windows SDK.
DI_NOBROWSE
Atur bendera ini untuk menonaktifkan penjelajahan jika operasi salin tidak dapat menemukan file tertentu. Jika pemanggil menyediakan antrean file, bendera ini diabaikan.
DI_FORCECOPY
Atur bendera ini untuk selalu menyalin file, meskipun sudah ada di komputer pengguna. Jika pemanggil menyediakan antrean file, bendera ini diabaikan.
DI_QUIETINSTALL
Atur bendera ini untuk menekan antarmuka pengguna kecuali benar-benar diperlukan. Misalnya, jangan tampilkan dialog kemajuan. Jika pemanggil menyediakan antrean file, bendera ini diabaikan.
[in, optional] FileQueue
Jika bendera DI_NOVCP diatur, parameter ini memasok handel ke antrean file tempat operasi file harus diantrekan tetapi tidak dilakukan.
[in, optional] InterfaceClassGuid
Pointer ke GUID yang mengidentifikasi kelas antarmuka yang akan diinstal. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini ditentukan, fungsi ini sedang digunakan untuk menginstal kelas antarmuka yang diwakili oleh GUID. Jika parameter ini NULL, fungsi ini sedang digunakan untuk menginstal penginstal kelas.
Reserved1
Dicadangkan. Harus nol.
Reserved2
Dicadangkan. Harus nol.
Mengembalikan nilai
SetupDiInstallClassEx mengembalikan TRUE jika berhasil. Jika tidak, kesalahan mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError.
Keterangan
Pemanggil fungsi ini harus menjadi anggota grup Administrator.
SetupDiInstallClassEx biasanya dipanggil oleh penginstal kelas untuk menginstal kelas penyiapan perangkat baru atau kelas antarmuka perangkat baru.
Catatan
Header setupapi.h mendefinisikan SetupDiInstallClassEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor 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.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru. |
| Target Platform | Desktop |
| Header | setupapi.h (termasuk Setupapi.h) |
| Pustaka | Setupapi.lib |