HKEY
SetupDiDeleteDevRegKey(
IN HDEVINFO DeviceInfoSet,
IN PSP_DEVINFO_DATA DeviceInfoData,
IN DWORD Scope,
IN DWORD HwProfile,
IN DWORD KeyType
);
SetupDiDeleteDevRegKey deletes the specified registry key(s) associated with a device information element.
Parameters
DeviceInfoSet
Supplies a handle to the device information set containing the device instance whose registry configuration storage key is to be deleted.
DeviceInfoData
Supplies a pointer to an SP_DEVINFO_DATA structure indicating the device instance for which to delete registry key(s).
Scope
Specifies the scope of the registry key to delete. The scope indicates where the information is located. The key can be global or hardware profile-specific. Can be one of the following values:
DICS_FLAG_GLOBAL
Delete the key that stores global configuration information.
DICS_FLAG_CONFIGSPECIFIC
Delete the key that stores hardware profile-specific configuration information.
HwProfile
If Scope is set to DICS_FLAG_CONFIGSPECIFIC, the HwProfile parameter specifies the hardware profile for which to delete the registry key. If HwProfile is 0, the key for the current hardware profile is deleted. If HwProfile is 0xFFFFFFFF, the registry key for all hardware profiles is deleted.
KeyType
Specifies the type of registry storage key to delete. Can be one of the following values:
DIREG_DEV
Delete the hardware registry key for the device. This is the key for storage of driver-independent configuration information. This key is in the Device Instance key of the Enum branch.
DIREG_DRV
Delete a software, or driver, registry key for the device. This key is located in the Class branch.
DIREG_BOTH
Delete both the hardware and software keys for the device.
Return Value
The function returns TRUE if it is successful. Otherwise it returns FALSE and the logged error can be retrieved with a call to GetLastError.
See Also