Fonction SetupDiGetClassRegistryPropertyW (setupapi.h)
La fonction SetupDiGetClassRegistryProperty récupère une propriété pour une classe d’installation d’appareil spécifiée à partir du Registre.
Syntaxe
WINSETUPAPI BOOL SetupDiGetClassRegistryPropertyW(
[in] const GUID *ClassGuid,
[in] DWORD Property,
[out, optional] PDWORD PropertyRegDataType,
[out] PBYTE PropertyBuffer,
[in] DWORD PropertyBufferSize,
[out, optional] PDWORD RequiredSize,
[in, optional] PCWSTR MachineName,
PVOID Reserved
);
Paramètres
[in] ClassGuid
Pointeur vers un GUID représentant la classe d’installation de l’appareil pour laquelle une propriété doit être récupérée.
[in] Property
Valeur qui identifie la propriété à récupérer. Il doit s’agir de l’une des valeurs suivantes :
SPCRP_CHARACTERISTICS
La fonction retourne des indicateurs indiquant les caractéristiques de l’appareil pour la classe . Pour obtenir la liste des indicateurs de caractéristiques, consultez le paramètre DeviceCharacteristics sur IoCreateDevice.
SPCRP_DEVTYPE
La fonction retourne une valeur DWORD qui représente le type d’appareil de la classe . Pour plus d’informations, consultez Spécification de types d’appareils.
SPCRP_EXCLUSIVE
La fonction retourne une valeur DWORD indiquant si les utilisateurs peuvent obtenir un accès exclusif aux appareils pour cette classe. La valeur retournée est une si l’accès exclusif est autorisé, ou zéro dans le cas contraire.
SPCRP_LOWERFILTERS
(Windows Vista et versions ultérieures) La fonction retourne 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.
SPCRP_SECURITY
La fonction retourne 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
La fonction retourne 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) La fonction retourne 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.
[out, optional] PropertyRegDataType
Pointeur vers une variable de type DWORD qui reçoit le type de données de propriété comme l’un des types de données de Registre préfixés REG_. Ce paramètre est facultatif et peut être NULL. Si ce paramètre a la valeur NULL, SetupDiGetClassRegistryProperty ne retourne pas le type de données.
[out] PropertyBuffer
Pointeur vers une mémoire tampon qui reçoit la propriété demandée.
[in] PropertyBufferSize
Taille, en octets, de la mémoire tampon PropertyBuffer .
[out, optional] RequiredSize
Pointeur vers une variable de type DWORD qui reçoit la taille requise, en octets, de la mémoire tampon PropertyBuffer . Si la mémoire tampon PropertyBuffer est trop petite et que RequiredSize n’a pas la valeur NULL, la fonction définit RequiredSize sur la taille de mémoire tampon minimale requise pour recevoir la propriété demandée.
[in, optional] MachineName
Pointeur vers une chaîne terminée par NULL qui contient le nom d’un système distant à partir duquel récupérer 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 récupérée à partir 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
Notes
L’en-tête setupapi.h définit SetupDiGetClassRegistryProperty 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 | DesktopPour universel, appelez CM_Get_Class_Registry_Property |
| En-tête | setupapi.h (inclure Setupapi.h) |
| Bibliothèque | Setupapi.lib |
Voir aussi
SetupDiGetDeviceRegistryProperty