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 |