Fonction SetupDiDeleteDevRegKey (setupapi.h)

La fonction SetupDiDeleteDevRegKey supprime les clés de Registre accessibles à l’utilisateur spécifiées qui sont associées à un élément d’informations sur l’appareil.

Syntaxe

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

Paramètres

[in] DeviceInfoSet

Handle du jeu d’informations sur l’appareil qui contient un élément d’informations sur l’appareil qui représente l’appareil pour lequel supprimer des clés de Registre. Le jeu d’informations sur l’appareil ne doit pas contenir d’éléments distants.

[in] DeviceInfoData

Pointeur vers une structure de SP_DEVINFO_DATA qui spécifie l’élément d’informations sur l’appareil dans DeviceInfoSet.

[in] Scope

Étendue de la clé de Registre à supprimer. L’étendue indique où se trouvent les informations. La clé peut être globale ou spécifique au profil matériel. Peut avoir l’une des valeurs suivantes :

DICS_FLAG_GLOBAL

Supprimez la clé qui stocke les informations de configuration globale.

DICS_FLAG_CONFIGSPECIFIC

Supprimez la clé qui stocke les informations de configuration spécifiques au profil matériel.

[in] HwProfile

Si Étendue est définie sur DICS_FLAG_CONFIGSPECIFIC, le paramètre HwProfile spécifie le profil matériel pour lequel supprimer la clé de Registre. Si HwProfile a la valeur 0, la clé du profil matériel actuel est supprimée. Si HwProfile est 0xFFFFFFFF, la clé de Registre de tous les profils matériels est supprimée.

[in] KeyType

Type de clé de stockage du Registre à supprimer. Peut avoir l’une des valeurs suivantes :

DIREG_DEV

Supprimez la clé matérielle de l’appareil.

DIREG_DRV

Supprimez la clé logicielle de l’appareil.

DIREG_BOTH

Supprimez les clés matérielles et logicielles de l’appareil.

Valeur retournée

La fonction retourne TRUE si elle réussit. Sinon, il retourne FALSE et l’erreur journalisée peut être récupérée avec un appel à GetLastError.

Remarques

L’appelant de cette fonction doit être membre du groupe Administrateurs.

Le DeviceInfoSet doit uniquement contenir des éléments sur l’ordinateur local.

Configuration requise

Voir aussi

SetupDiCreateDevRegKey

SetupDiGetHwProfileList