SetupDiDeleteDevRegKey 関数 (setupapi.h)

[アーティクル]
08/26/2023

SetupDiDeleteDevRegKey 関数は、デバイス情報要素に関連付けられている指定されたユーザーアクセス可能なレジストリキーを削除します。

構文

WINSETUPAPI BOOL SetupDiDeleteDevRegKey(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData,
  [in] DWORD            Scope,
  [in] DWORD            HwProfile,
  [in] DWORD            KeyType
);

パラメーター

[in] DeviceInfoSet

レジストリキーを削除するデバイスを表すデバイス情報要素を含むデバイス情報セットへのハンドル。デバイス情報セットにリモート要素を含めてはなりません。

[in] DeviceInfoData

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

[in] Scope

削除するレジストリキーのスコープ。スコープは、情報が配置されている場所を示します。キーには、グローバルプロファイルまたはハードウェアプロファイル固有のキーを指定できます。値は、次のいずれかです。

DICS_FLAG_GLOBAL

グローバル構成情報を格納するキーを削除します。

DICS_FLAG_CONFIGSPECIFIC

ハードウェアプロファイル固有の構成情報を格納しているキーを削除します。

[in] HwProfile

Scope が DICS_FLAG_CONFIGSPECIFIC に設定されている場合、HwProfile パラメーターは、レジストリキーを削除するハードウェアプロファイルを指定します。 HwProfile が 0 の場合、現在のハードウェアプロファイルのキーが削除されます。 HwProfile が0xFFFFFFFF場合、すべてのハードウェアプロファイルのレジストリキーが削除されます。

[in] KeyType

削除するレジストリストレージキーの種類。値は、次のいずれかです。

DIREG_DEV

デバイスのハードウェアキーを削除します。

DIREG_DRV

デバイスのソフトウェアキーを削除します。

DIREG_BOTH

デバイスのハードウェアキーとソフトウェアキーの両方を削除します。

戻り値

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

解説

この関数の呼び出し元は、Administrators グループのメンバーである必要があります。

DeviceInfoSet には、ローカルコンピューター上の要素のみが含まれている必要があります。

要件


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