Fungsi SetupDiInstallClassExA (setupapi.h)

Fungsi SetupDiInstallClassEx menginstal penginstal kelas atau kelas antarmuka.

Sintaksis

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 NULL.

[in, optional] InfFileName

Penunjuk ke string yang dihentikan NULL yang berisi nama file INF. Parameter ini bersifat opsional dan dapat 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 diantrekan.

Untuk informasi selengkapnya tentang fungsi SetupInstallFromInfSection , lihat dokumentasi Microsoft Windows SDK.

DI_NOBROWSE

Atur bendera ini untuk menonaktifkan penjelajahan jika operasi penyalinan tidak dapat menemukan file tertentu. Jika penelepon menyediakan antrean file, bendera ini diabaikan.

DI_FORCECOPY

Atur bendera ini untuk selalu menyalin file, meskipun sudah ada di komputer pengguna. Jika penelepon 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 penelepon 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 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

Dipesan. Harus nol.

Reserved2

Dipesan. Harus nol.

Mengembalikan nilai

SetupDiInstallClassEx mengembalikan TRUE jika berhasil. Jika tidak, ini mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError.

Komentar

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 Kelas antarmuka juga dapat diinstal secara otomatis dengan memanggil SetupDiInstallDeviceInterfaces untuk menginstal antarmuka perangkat untuk perangkat.

 

Nota

Header setupapi.h mendefinisikan SetupDiInstallClassEx 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

Syarat	Nilai
klien minimum yang didukung	Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Platform Target	Desktop
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib

Lihat juga

SetupDiCallClassInstaller

SetupDiInstallDeviceInterfaces