Fungsi SetupDiRemoveDevice (setupapi.h)

Artikel
03/04/2024

Fungsi SetupDiRemoveDevice adalah handler default untuk permintaan penginstalan DIF_REMOVE .

Sintaks

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

Parameter

[in] DeviceInfoSet

Handel ke informasi perangkat yang diatur untuk sistem lokal yang berisi elemen informasi perangkat yang mewakili perangkat untuk dihapus.

[in, out] DeviceInfoData

Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat di DeviceInfoSet. Ini adalah parameter IN-OUT karena DeviceInfoSet. DevInst mungkin diperbarui dengan nilai handel baru saat dikembalikan. Jika ini adalah penghapusan global atau penghapusan khusus profil perangkat keras terakhir, semua jejak instans perangkat dihapus dari registri dan handelnya adalah NULL.

Nilai kembali

Fungsi mengembalikan TRUE jika berhasil. Jika tidak, ia mengembalikan FALSE dan kesalahan yang dicatat dapat diambil oleh panggilan ke GetLastError.

Keterangan

SetupDiRemoveDevice menghapus perangkat dari sistem. Ini menghapus kunci registri perangkat keras dan perangkat lunak perangkat dan kunci registri khusus profil perangkat keras apa pun (kunci registri khusus konfigurasi). Fungsi ini secara dinamis menghentikan perangkat jika DevInst-nya aktif dan ini adalah penghapusan global atau penghapusan khusus konfigurasi terakhir. Jika perangkat tidak dapat dihentikan secara dinamis, bendera diatur di blok Parameter Penginstalan dari kumpulan informasi perangkat yang akhirnya menyebabkan pengguna diminta untuk memulai ulang komputer.

Penghapusan perangkat bersifat global ke semua profil perangkat keras atau khusus untuk satu profil perangkat keras seperti yang ditentukan oleh anggota Cakupan dari struktur SP_REMOVEDEVICE_PARAMS yang memasok parameter penginstalan kelas untuk permintaan DIF_REMOVE. Penghapusan khusus konfigurasi hanya sesuai untuk perangkat yang dijumlahkan akar dan hanya boleh diminta oleh kode sistem.

Pemanggil SetupDiRemoveDevice harus menjadi anggota grup Administrator.

Catatan Hanya penginstal kelas yang harus memanggil SetupDiRemoveDevice dan hanya dalam situasi di mana alat penginstal kelas harus melakukan operasi penghapusan perangkat setelah SetupDiRemoveDevice menyelesaikan operasi penghapusan perangkat default. Dalam situasi seperti itu, penginstal kelas harus langsung memanggil SetupDiRemoveDevice ketika alat penginstal memproses permintaan DIF_REMOVE. Untuk informasi selengkapnya tentang memanggil handler default, lihat Memanggil Penangan Kode DIF Default.

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

SP_DEVINFO_DATA

SP_REMOVEDEVICE_PARAMS

Bagikan melalui