Fungsi SetupDiUnremoveDevice (setupapi.h)

Fungsi SetupDiUnremoveDevice adalah handler default untuk permintaan penginstalan DIF_UNREMOVE .

Sintaks

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

Parameter

[in] DeviceInfoSet

Handel ke set informasi perangkat untuk sistem lokal yang berisi elemen informasi perangkat yang mewakili perangkat untuk dipulihkan dan dimulai ulang.

[in, out] DeviceInfoData

Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat di DeviceInfoSet. Ini adalah parameter IN-OUT karena DeviceInfoData.DevInst mungkin diperbarui dengan nilai handel baru saat dikembalikan.

Nilai kembali

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

Keterangan

SetupDiUnremoveDevice memulihkan perangkat ke profil perangkat keras. Fungsi ini memulai perangkat, jika memungkinkan, atau mengatur bendera di parameter penginstalan perangkat yang akhirnya menyebabkan pengguna diminta untuk mematikan sistem.

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

 

Perangkat yang dipulihkan harus memiliki parameter penginstalan kelas untuk DIF_UNREMOVE atau fungsi gagal dan GetLastError mengembalikan ERROR_NO_CLASSINSTALL_PARAMS.

DeviceInfoSet hanya boleh berisi elemen di komputer lokal.

Pemanggil SetupDiUnremoveDevice harus menjadi anggota grup Administrator.

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_UNREMOVE

SP_DEVINFO_DATA

SetupDiRemoveDevice