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

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.