Fungsi SetupDiInstallClassW (setupapi.h)

Fungsi SetupDiInstallClass menginstal bagian ClassInstall32 dari file INF yang ditentukan.

Sintaksis

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 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 antreannya sendiri dan menggunakan antrean yang disediakan pemanggil sebagai gantinya. Jika bendera ini diatur, file tidak disalin hanya diantrekan.

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.

Mengembalikan nilai

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

Fungsi ini dipanggil oleh penginstal kelas saat menginstal perangkat dari kelas perangkat baru.

Untuk menginstal kelas antarmuka atau kelas perangkat, gunakan SetupDiInstallClassEx.

Nota

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

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

SetupDiInstallClassEx