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

Consulte también

SetupDiCreateDevRegKey

SetupDiGetHwProfileList