Fungsi SetupDiRemoveDeviceInterface (setupapi.h)

Fungsi SetupDiRemoveDeviceInterface menghapus antarmuka perangkat terdaftar dari sistem.

Sintaks

WINSETUPAPI BOOL SetupDiRemoveDeviceInterface(
  [in]      HDEVINFO                  DeviceInfoSet,
  [in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData
);

Parameter

[in] DeviceInfoSet

Penunjuk ke kumpulan informasi perangkat yang berisi antarmuka perangkat untuk dihapus. Handel ini biasanya dikembalikan oleh SetupDiGetClassDevs.

[in, out] DeviceInterfaceData

Penunjuk ke struktur SP_DEVICE_INTERFACE_DATA yang menentukan antarmuka perangkat di DeviceInfoSet untuk dihapus. Pointer ini biasanya dikembalikan oleh SetupDiEnumDeviceInterfaces.

Setelah antarmuka dihapus, fungsi ini mengatur bendera SPINT_REMOVED di DeviceInterfaceData. Bendera. Ini juga menghapus bendera SPINT_ACTIVE, tetapi ketahuilah bahwa bendera ini seharusnya sudah dihapus sebelum fungsi ini dipanggil.

Menampilkan nilai

SetupDiRemoveDeviceInterface mengembalikan TRUE jika fungsi selesai tanpa kesalahan. Jika fungsi selesai dengan kesalahan, fungsi mengembalikan FALSE dan kode kesalahan untuk kegagalan dapat diambil dengan memanggil GetLastError.

Keterangan

Pemanggil fungsi ini harus menjadi anggota grup Administrator.

SetupDiRemoveDeviceInterface menghapus antarmuka perangkat yang ditentukan dari sistem. Ini termasuk menghapus kunci registri terkait.

Panggil SetupDiDeleteDeviceInterfaceData untuk menghapus antarmuka dari daftar informasi perangkat.

Antarmuka perangkat harus dinonaktifkan untuk dihapus. Jika antarmuka diaktifkan, fungsi ini gagal dan GetLastError mengembalikan ERROR_DEVICE_INTERFACE_ACTIVE. Nonaktifkan antarmuka dengan menggunakan mekanisme khusus antarmuka apa pun yang disediakan (misalnya, IOCTL). Jika penelepon tidak memiliki cara untuk menonaktifkan antarmuka dan antarmuka harus dihapus, pemanggil harus menghentikan perangkat yang mendasar dengan menggunakan SetupDiChangeState. Menghentikan perangkat menonaktifkan semua antarmuka yang diekspos oleh perangkat.

Persyaratan

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

SetupDiChangeState

SetupDiCreateDeviceInterface

SetupDiDeleteDeviceInterfaceData

SetupDiEnumDeviceInterfaces

SetupDiGetClassDevs