Fungsi SetupDiRegisterCoDeviceInstallers (setupapi.h)

Fungsi SetupDiRegisterCoDeviceInstallers adalah handler default untuk DIF_REGISTER_COINSTALLERS.

Sintaks

WINSETUPAPI BOOL SetupDiRegisterCoDeviceInstallers(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

Parameter

[in] DeviceInfoSet

Handel ke kumpulan informasi perangkat yang berisi elemen informasi perangkat yang mewakili perangkat untuk mendaftarkan penginstal bersama. Kumpulan informasi perangkat tidak boleh berisi elemen jarak jauh apa pun.

[in] DeviceInfoData

Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat di DeviceInfoSet.

Nilai kembali

SetupDiRegisterCoDeviceInstallers mengembalikan TRUE jika fungsi berhasil. Jika fungsi mengembalikan FALSE, panggil GetLastError untuk informasi kesalahan yang diperluas.

Keterangan

Pemanggil SetupDiRegisterCoDeviceInstallers harus menjadi anggota grup Administrator.

Catatan Hanya penginstal kelas yang harus memanggil SetupDiRegisterCoDeviceInstallers dan hanya dalam situasi di mana penginstal kelas harus melakukan operasi pendaftaran penginstal bersama setelah SetupDiRegisterCoDeviceInstallers menyelesaikan operasi pendaftaran penginstal bersama default. Dalam situasi seperti itu, penginstal kelas harus langsung memanggil SetupDiRegisterCoDeviceInstallers saat alat penginstal memproses permintaan DIF_REGISTER_COINSTALLERS. Untuk informasi selengkapnya tentang memanggil handler default, lihat Memanggil Penangan Kode DIF Default.

 

SetupDiRegisterCoDeviceInstallers membaca file INF untuk perangkat yang ditentukan oleh DeviceInfoData dan membuat entri registri untuk mendaftarkan rekan penginstal khusus perangkat yang tercantum dalam file INF. Penginstal bersama tercantum di bagian INF DDInstall.CoInstallers. Fungsi ini juga menyalin file untuk penginstal bersama, kecuali bendera DI_NOFILECOPY diatur.

Jika tidak ada driver yang dipilih, atau perangkat memiliki file INF untuk Windows 9x atau Millennium Edition, fungsi ini tidak mendaftarkan penginstal bersama.

Mendaftarkan penginstal bersama khusus perangkat baru membatalkan daftar penginstal bersama Penginstal Perangkat saat ini. Setelah pendaftaran berhasil, Penginstal Perangkat memperbarui daftar rekan penginstalnya.

Fungsi ini hanya mendaftarkan rekan penginstal khusus perangkat, bukan rekan penginstal kelas.

Untuk informasi selengkapnya tentang cara menulis dan mendaftarkan rekan penginstal khusus perangkat, lihat Menulis Penginstal Bersama.

Set informasi perangkat yang ditentukan oleh DeviceInfoSet hanya boleh berisi elemen pada komputer lokal.

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
DLL	Setupapi.dll

Lihat juga

DIF_REGISTER_COINSTALLERS

SetupDiCallClassInstaller