SetupDiSetClassRegistryPropertyW, fonction (setupapi.h)
La fonction SetupDiSetClassRegistryProperty définit une propriété de classe d’appareil spécifiée dans le Registre.
Syntaxe
WINSETUPAPI BOOL SetupDiSetClassRegistryPropertyW(
[in] const GUID *ClassGuid,
[in] DWORD Property,
[in, optional] const BYTE *PropertyBuffer,
[in] DWORD PropertyBufferSize,
[in, optional] PCWSTR MachineName,
PVOID Reserved
);
Paramètres
[in] ClassGuid
Pointeur vers le GUID qui identifie la classe d’appareil pour laquelle une propriété doit être définie.
[in] Property
Valeur qui identifie la propriété à définir, qui doit être l’une des suivantes :
SPCRP_CHARACTERISTICS
L’appelant fournit des indicateurs qui spécifient les caractéristiques de l’appareil pour la classe. Pour obtenir la liste des indicateurs de caractéristiques, consultez le paramètre DeviceCharacteristics de IoCreateDevice. Les caractéristiques de l’appareil doivent être définies lorsque la classe d’appareil est installée et ne doivent pas être modifiées une fois la classe d’appareil installée.
SPCRP_DEVTYPE
L’appelant fournit le type d’appareil pour la classe. Pour plus d’informations, consultez Spécification des types d’appareils. Le type d’appareil doit être défini lorsqu’une classe d’appareil est installée et ne doit pas être modifiée une fois la classe d’appareil installée.
SPCRP_EXCLUSIVE
L’appelant fournit une valeur DWORD qui spécifie si les utilisateurs peuvent obtenir un accès exclusif aux appareils pour cette classe. La valeur fournie est 1 si l’accès exclusif est autorisé ou zéro dans le cas contraire. Le paramètre exclusif d’un appareil doit être défini lorsqu’une classe d’appareil est installée et ne doit pas être modifiée une fois la classe d’appareil installée.
SPCRP_LOWERFILTERS
(Windows Vista et versions ultérieures) L’appelant fournit une liste REG_MULTI_SZ des noms de service des pilotes de filtre inférieur installés pour la classe de configuration de périphérique . Pour plus d’informations sur l’installation d’un pilote de filtre de classe, consultez Installation d’un pilote de filtre et section INF ClassInstall32.
SPCRP_SECURITY
L’appelant fournit le descripteur de sécurité de l’appareil en tant que structure SECURITY_DESCRIPTOR au format auto-relatif (décrit dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows).
SPCRP_SECURITY_SDS
L’appelant fournit le descripteur de sécurité de l’appareil en tant que chaîne de texte. Pour plus d’informations sur les chaînes de descripteur de sécurité, consultez langage de définition du descripteur de sécurité (Windows). Pour plus d’informations sur le format des chaînes de descripteur de sécurité, consultez Security Descriptor Definition Language (Windows).
SPCRP_UPPERFILTERS
(Windows Vista et versions ultérieures) L’appelant fournit une liste REG_MULTI_SZ des noms de service des pilotes de filtre supérieur installés pour la classe d’installation de périphérique. Pour plus d’informations sur l’installation d’un pilote de filtre de classe, consultez Installation d’un pilote de filtre et section INF ClassInstall32.
[in, optional] PropertyBuffer
Pointeur vers une mémoire tampon qui fournit la propriété spécifiée. Ce paramètre est facultatif et peut être NULL.
[in] PropertyBufferSize
Taille, en octets, de la mémoire tampon PropertyBuffer .
[in, optional] MachineName
Pointeur vers une chaîne terminée par NULL qui contient le nom d’un système distant sur lequel définir la propriété de classe d’appareil spécifiée. Ce paramètre est facultatif et peut être NULL. Si ce paramètre est NULL, la propriété est définie sur le nom du système local.
Prudence
L’utilisation de cette fonction pour accéder aux machines distantes n’est pas prise en charge à partir de Windows 8 et Windows Server 2012, car cette fonctionnalité a été supprimée.
Reserved
Réservé, doit être NULL .
Valeur de retour
La fonction retourne TRUE si elle réussit. Sinon, elle retourne FAUX 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.
Pour déterminer le type de données d’une propriété de classe d’appareil, appelez SetupDiGetClassRegistryProperty.
Note
L’en-tête setupapi.h définit SetupDiSetClassRegistryProperty en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows XP et versions ultérieures de Windows. |
| plateforme cible | Bureau |
| d’en-tête | setupapi.h (include Setupapi.h) |
| bibliothèque | Setupapi.lib |
Voir aussi
SetupDiGetClassRegistryProperty