SetupDiGetClassRegistryPropertyA, fonction (setupapi.h)
La fonction SetupDiGetClassRegistryProperty récupère une propriété pour une classe de configuration d’appareil spécifiée à partir du Registre.
Syntaxe
WINSETUPAPI BOOL SetupDiGetClassRegistryPropertyA(
[in] const GUID *ClassGuid,
[in] DWORD Property,
[out, optional] PDWORD PropertyRegDataType,
[out] PBYTE PropertyBuffer,
[in] DWORD PropertyBufferSize,
[out, optional] PDWORD RequiredSize,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Paramètres
[in] ClassGuid
Pointeur vers un GUID représentant la classe de configuration 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 pour 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 des 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 valeur si l’accès exclusif est autorisé ou zéro sinon.
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 périphérique.
SPCRP_SECURITY
La fonction retourne 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
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 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) 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 périphérique.
[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 est 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
[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 est NULL, la propriété est récupérée à partir 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
Note
L’en-tête setupapi.h définit SetupDiGetClassRegistryProperty 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 | DesktopFor universal, appel CM_Get_Class_Registry_Property |
| d’en-tête | setupapi.h (include Setupapi.h) |
| bibliothèque | Setupapi.lib |
Voir aussi
SetupDiGetDeviceRegistryProperty