SetupDiDeleteDeviceInfo 関数 (setupapi.h)

  • [アーティクル]

SetupDiDeleteDeviceInfo 関数は、デバイス情報セットからデバイス情報要素を削除します。 この関数は、実際のデバイスを削除しません。

構文

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

パラメーター

[in] DeviceInfoSet

削除する デバイス情報 要素を含むデバイス情報セットへのハンドル。

[in] DeviceInfoData

削除する DeviceInfoSet のデバイス情報要素を表すSP_DEVINFO_DATA構造体へのポインター。

戻り値

成功した場合、この関数は TRUE を 返します。 それ以外の場合は FALSE を 返し、ログに記録されたエラーは GetLastError の呼び出しで取得できます。

注釈

指定したデバイス情報要素が使用されている場合 (ウィザード ページなど)、関数は失敗します。 この場合、 GetLastError を呼び出すとERROR_DEVINFO_DATA_LOCKEDが返されます。 これは、このデバイス情報要素が指定され、DIWP_FLAG_USE_DEVINFO_DATA フラグが設定された SetupDiGetWizardPage の呼び出しでウィザード ページへのハンドルが取得された場合に発生します。 このデバイス情報要素を削除するには、まずウィザードの HPROPSHEETPAGE ハンドルを閉じる必要があります。

要件

要件 値
サポートされている最小のクライアント Microsoft Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム デスクトップ
Header setupapi.h (Setupapi.h を含む)
Library Setupapi.lib
[DLL] Setupapi.dll

こちらもご覧ください

SetupDiCreateDeviceInfo

SetupDiEnumDeviceInfo

SetupDiGetWizardPage

SetupDiOpenDeviceInfo