Partager via

Définition des propriétés du registre d’objets d’appareil après l’installation

  • Article

Un programme en mode utilisateur peut utiliser les fonctions d’installation d’appareil pour obtenir ou définir les paramètres de Registre pour les propriétés de l’objet de périphérique d’un pilote. Normalement, ces fonctions sont utilisées par les logiciels d’installation, mais elles peuvent être utilisées par n’importe quel programme en mode utilisateur. (Le programme doit être exécuté par un utilisateur disposant d’un accès Administrateur.)

Les fonctions SetupDiGetDeviceRegistryProperty et SetupDiSetDeviceRegistryProperty obtiennent et définissent la clé de Registre pour chaque propriété spécifiée. Le paramètre Property spécifie la propriété à obtenir ou à définir. PropertyBuffer pointe vers la mémoire tampon de destination (lors de l’obtention de la propriété) ou la mémoire tampon source (lors de la définition de la propriété) pour la propriété.

La correspondance entre les valeurs du paramètre Property et les propriétés réelles est la suivante.

Valeur du paramètre Property Propriété de l’objet Device

SPDRP_CHARACTERISTICS

Caractéristiques de l’appareil

SPDRP_DEVTYPE

Type d’appareil

SPDRP_EXCLUSIVE

Exclusif

SPDRP_SECURITY

Descripteur de sécurité en tant que structure de SECURITY_DESCRIPTOR

SPDRP_SECURITY_SDS

Descripteur de sécurité en tant que chaîne SDDL

Notez que deux méthodes différentes sont fournies pour obtenir ou définir le descripteur de sécurité. Vous pouvez spécifier la valeur SPDRP_SECURITY pour traiter le descripteur de sécurité comme une structure de SECURITY_DESCRIPTOR ou SPDRP_SECURITY_SDS pour traiter le descripteur de sécurité comme une chaîne SDDL. Pour plus d’informations sur les chaînes SDDL, consultez SDDL for Device Objects.

Pour les systèmes d’exploitation Windows XP et ultérieurs, les programmes peuvent également obtenir et définir les valeurs de propriété pour une classe d’installation d’appareil. Utilisez les fonctions SetupDiGetClassRegistryProperty et SetupDiSetClassRegistryProperty pour obtenir et définir les valeurs de propriété d’une classe d’installation d’appareil.

Pour plus d’informations sur l’utilisation des fonctions SetupDiXxx , consultez Utilisation des fonctions d’installation d’appareil.