CM_Get_DevNode_Registry_PropertyW, fonction (cfgmgr32.h)
La fonction CM_Get_DevNode_Registry_Property récupère une propriété d’appareil spécifiée à partir du Registre.
Syntaxe
CMAPI CONFIGRET CM_Get_DevNode_Registry_PropertyW(
[in] DEVINST dnDevInst,
[in] ULONG ulProperty,
[out, optional] PULONG pulRegDataType,
[out, optional] PVOID Buffer,
[in, out] PULONG pulLength,
[in] ULONG ulFlags
);
Paramètres
[in] dnDevInst
Un handle d’appareil fourni par l’appelant instance lié à l’ordinateur local.
[in] ulProperty
Valeur constante préfixée CM_DRP_ qui identifie la propriété d’appareil à obtenir à partir du Registre. Ces constantes sont définies dans Cfgmgr32.h.
[out, optional] pulRegDataType
Facultatif, peut être NULL. Pointeur vers un emplacement qui reçoit le type de données de Registre, spécifié en tant que constante préfixée REG_ définie dans Winnt.h.
[out, optional] Buffer
Facultatif, peut être NULL. Pointeur vers une mémoire tampon fournie par l’appelant qui reçoit la propriété d’appareil demandée. Si cette valeur est NULL, la fonction fournit uniquement la longueur des données demandées dans l’adresse pointée par pulLength.
[in, out] pulLength
Pointeur vers une variable ULONG dans laquelle la fonction stocke la longueur, en octets, de la propriété d’appareil demandée.
Si le paramètre Buffer est défini sur NULL, la variable ULONG doit être définie sur zéro.
Si le paramètre Buffer n’est pas défini sur NULL, la variable ULONG doit être définie sur la longueur, en octets, de la mémoire tampon fournie par l’appelant.
[in] ulFlags
Non utilisé, doit être égal à zéro.
Valeur retournée
Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, elle retourne l’un des codes d’erreur préfixés CR_ définis dans Cfgmgr32.h.
Remarques
Pour plus d’informations sur l’utilisation des handles de instance d’appareil qui sont liés à l’ordinateur local, consultez CM_Get_Child.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Microsoft Windows 2000. |
| Plateforme cible | Universal |
| En-tête | cfgmgr32.h (inclure Cfgmgr32.h) |
| Bibliothèque | Cfgmgr32.lib |