共用方式為

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

另請參閱

SetupDiCreateDeviceInfo

SetupDiEnumDeviceInfo

SetupDiGetWizardPage

SetupDiOpenDeviceInfo