Función SetupDiDeleteDevRegKey (setupapi.h)
La función SetupDiDeleteDevRegKey elimina las claves del Registro accesibles para el usuario especificadas asociadas a un elemento de información del dispositivo.
Sintaxis
WINSETUPAPI BOOL SetupDiDeleteDevRegKey(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD Scope,
[in] DWORD HwProfile,
[in] DWORD KeyType
);
Parámetros
[in] DeviceInfoSet
Identificador del conjunto de información del dispositivo que contiene un elemento de información del dispositivo que representa el dispositivo para el que se eliminarán las claves del Registro. El conjunto de información del dispositivo no debe contener elementos remotos.
[in] DeviceInfoData
Puntero a una estructura de SP_DEVINFO_DATA que especifica el elemento de información del dispositivo en DeviceInfoSet.
[in] Scope
Ámbito de la clave del Registro que se va a eliminar. El ámbito indica dónde se encuentra la información. La clave puede ser específica del perfil de hardware o global. Puede ser uno de los siguientes valores:
DICS_FLAG_GLOBAL
Elimine la clave que almacena información de configuración global.
DICS_FLAG_CONFIGSPECIFIC
Elimine la clave que almacena información de configuración específica del perfil de hardware.
[in] HwProfile
Si Scope se establece en DICS_FLAG_CONFIGSPECIFIC, el parámetro HwProfile especifica el perfil de hardware para el que se va a eliminar la clave del Registro. Si HwProfile es 0, se elimina la clave del perfil de hardware actual. Si HwProfile es 0xFFFFFFFF, se elimina la clave del Registro de todos los perfiles de hardware.
[in] KeyType
Tipo de clave de almacenamiento del Registro que se va a eliminar. Puede ser uno de los siguientes valores:
DIREG_DEV
Elimine la clave de hardware del dispositivo.
DIREG_DRV
Elimine la clave de software del dispositivo.
DIREG_BOTH
Elimine las claves de hardware y software del dispositivo.
Valor devuelto
La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar con una llamada a GetLastError.
Comentarios
El autor de la llamada de esta función debe ser miembro del grupo Administradores.
DeviceInfoSet solo debe contener elementos en el equipo local.
Requisitos
| Cliente mínimo compatible | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | setupapi.h (incluya Setupapi.h) |
| Library | Setupapi.lib |
| Archivo DLL | Setupapi.dll |