Fonction SetupDiSetClassRegistryPropertyA (setupapi.h)

La fonction SetupDiSetClassRegistryProperty définit une propriété de classe d’appareil spécifiée dans le Registre.

Syntaxe

WINSETUPAPI BOOL SetupDiSetClassRegistryPropertyA(
  [in]           const GUID *ClassGuid,
  [in]           DWORD      Property,
  [in, optional] const BYTE *PropertyBuffer,
  [in]           DWORD      PropertyBufferSize,
  [in, optional] PCSTR      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 DeviceCharacteristicsd’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 après l’installation de la classe d’appareil.

SPCRP_DEVTYPE

L’appelant fournit le type d’appareil pour la classe . Pour plus d’informations, consultez Spécification de 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é après l’installation de la classe d’appareil.

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é après l’installation de la classe d’appareil.

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érieurs installés pour la classe d’installation de l’appareil. Pour plus d’informations sur l’installation d’un pilote de filtre de classe, consultez La section Installation d’un pilote de filtre et de la classe INFInstall32.

SPCRP_SECURITY

L’appelant fournit le descripteur de sécurité de l’appareil sous la forme d’une structure SECURITY_DESCRIPTOR au format auto-relatif (décrit dans la documentation Microsoft Windows SDK).

SPCRP_SECURITY_SDS

L’appelant fournit le descripteur de sécurité de l’appareil sous forme de chaîne de texte. Pour plus d’informations sur les chaînes de descripteur de sécurité, consultez Security Descriptor Definition Language (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 l’appareil. Pour plus d’informations sur l’installation d’un pilote de filtre de classe, consultez La section Installation d’un pilote de filtre et de la classe INFInstall32.

[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 a la valeur NULL, la propriété est définie sur le nom du système local.

Attention

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 avoir la valeur NULL.

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.

Pour déterminer le type de données d’une propriété de classe d’appareil, appelez SetupDiGetClassRegistryProperty.

Notes

L’en-tête setupapi.h définit SetupDiSetClassRegistryProperty comme un 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows XP et les versions ultérieures de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	setupapi.h (inclure Setupapi.h)
Bibliothèque	Setupapi.lib

Voir aussi

SetupDiGetClassRegistryProperty

SetupDiGetDeviceRegistryProperty

SetupDiSetDeviceRegistryProperty