Funzione SetupDiDeleteDevRegKey (setupapi.h)

La funzione SetupDiDeleteDevRegKey elimina le chiavi del Registro di sistema accessibili dall'utente specificate associate a un elemento informazioni sul dispositivo.

Sintassi

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

Parametri

[in] DeviceInfoSet

Handle per il set di informazioni sul dispositivo che contiene un elemento informazioni sul dispositivo che rappresenta il dispositivo per cui eliminare le chiavi del Registro di sistema. Il set di informazioni sul dispositivo non deve contenere elementi remoti.

[in] DeviceInfoData

Puntatore a una struttura SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo in DeviceInfoSet.

[in] Scope

Ambito della chiave del Registro di sistema da eliminare. L'ambito indica dove si trovano le informazioni. La chiave può essere globale o specifica del profilo hardware. I possibili valori sono i seguenti:

DICS_FLAG_GLOBAL

Eliminare la chiave che archivia le informazioni di configurazione globali.

DICS_FLAG_CONFIGSPECIFIC

Eliminare la chiave che archivia le informazioni di configurazione specifiche del profilo hardware.

[in] HwProfile

Se Scope è impostato su DICS_FLAG_CONFIGSPECIFIC, il parametro HwProfile specifica il profilo hardware per cui eliminare la chiave del Registro di sistema. Se HwProfile è 0, la chiave per il profilo hardware corrente viene eliminata. Se HwProfile è 0xFFFFFFFF, la chiave del Registro di sistema per tutti i profili hardware viene eliminata.

[in] KeyType

Tipo di chiave di archiviazione del Registro di sistema da eliminare. I possibili valori sono i seguenti:

DIREG_DEV

Eliminare la chiave hardware del dispositivo.

DIREG_DRV

Eliminare la chiave software del dispositivo.

DIREG_BOTH

Eliminare sia l'hardware che le chiavi software per il dispositivo.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce TRUE . In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError.

Commenti

Il chiamante di questa funzione deve essere membro del gruppo Administrators.

DeviceInfoSet deve contenere solo elementi nel computer locale.

Requisiti

Client minimo supportato	Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	setupapi.h (include Setupapi.h)
Libreria	Setupapi.lib
DLL	Setupapi.dll

Vedi anche

SetupDiCreateDevRegKey

SetupDiGetHwProfileList