Fungsi SetupDiInstallClassW (setupapi.h)
Fungsi SetupDiInstallClass menginstal bagian ClassInstall32 dari file INF yang ditentukan.
Sintaks
WINSETUPAPI BOOL SetupDiInstallClassW(
[in, optional] HWND hwndParent,
[in] PCWSTR InfFileName,
[in] DWORD Flags,
[in, optional] HSPFILEQ FileQueue
);
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] InfFileName
Penunjuk ke string yang dihentikan NULL yang berisi nama file INF yang berisi bagian INF ClassInstall32.
[in] Flags
Bendera ini mengontrol proses penginstalan. Dapat berupa kombinasi dari yang berikut ini:
DI_NOVCP
Atur bendera ini jika FileQueue disediakan. DI_NOVCP menginstruksikan fungsi SetupInstallFromInfSection (dijelaskan dalam dokumentasi Microsoft Windows SDK) untuk tidak membuat antrean sendiri dan menggunakan antrean yang disediakan pemanggil sebagai gantinya. Jika bendera ini diatur, file tidak disalin hanya dalam antrean.
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.
Mengembalikan nilai
Fungsi 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.
Fungsi ini dipanggil oleh penginstal kelas saat menginstal perangkat dari kelas perangkat baru.
Untuk menginstal kelas antarmuka atau kelas perangkat, gunakan SetupDiInstallClassEx.
Catatan
Header setupapi.h mendefinisikan SetupDiInstallClass 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.
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 |