SetupDiDeleteDevRegKey 函式 (setupapi.h)
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 中使用。 |
| 目標平台 | 桌上型 |
| 標頭 | setupapi.h (包括 Setupapi.h) |
| 程式庫 | Setupapi.lib |
| Dll | Setupapi.dll |