SetupDiDeleteDeviceInfo 函式 (setupapi.h)
SetupDiDeleteDeviceInfo 函式會從裝置資訊集刪除裝置資訊元素。 此函式不會刪除實際的裝置。
語法
WINSETUPAPI BOOL SetupDiDeleteDeviceInfo(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData
);
參數
[in] DeviceInfoSet
包含要刪除之 裝置資訊項目的裝置資訊集 句柄。
[in] DeviceInfoData
SP_DEVINFO_DATA 結構的指標，表示要刪除的 DeviceInfoSet 中的裝置信息專案。
傳回值
如果函式成功，函式會傳回 TRUE 。 否則，它會傳回 FALSE ，而且可以使用 呼叫 GetLastError 來擷取記錄的錯誤。
備註
例如，如果指定的裝置資訊元素正在使用 (，精靈頁面) ，則函式會失敗。 在此情況下， 呼叫 GetLastError 會傳回ERROR_DEVINFO_DATA_LOCKED。 如果擷取精靈頁面的句柄，並呼叫 SetupDiGetWizardPage 並指定此裝置資訊元素，並設定DIWP_FLAG_USE_DEVINFO_DATA旗標，就會發生這種情況。 若要刪除此裝置資訊元素，您必須先關閉精靈的 HPROPSHEETPAGE 句柄。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。 |
| 目標平台 | 桌面 |
| 標頭 | setupapi.h (包括 Setupapi.h) |
| 程式庫 | Setupapi.lib |
| Dll | Setupapi.dll |